ki-agents

Audit Claude Code subagent definitions against mechanical and judgment criteria.

Updated May 29, 2026
One-click install
npx skills add https://github.com/knowledgeislands/ki-agentic-harness --skill ki-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ki-agents
Source: https://github.com/knowledgeislands/ki-agentic-harness/tree/main/skills/ki-agents
Command: npx skills add https://github.com/knowledgeislands/ki-agentic-harness --skill ki-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps in auditing, reviewing, and writing Claude Code subagent definitions, ensuring they adhere to best practices and are well-scoped.

Core Features & Use Cases

  • Audit: Review existing subagent definitions against a comprehensive rubric.
  • Review: Critique and refine subagent definitions for quality and adherence to guidelines.
  • Write: Scaffold new subagent definitions with guidelines for best practice and structure.
  • Use Case: Create a new subagent for handling code reviews with predefined roles, lane, and tool requirements.

Quick Start

Run the 'audit' mode with 'init' to start the audit process for the subagent at './agents/code-reviewer.md'.

Frequently Asked Questions about ki-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit Claude Code subagent definitions for best practice compliance?

You can audit Claude Code subagent definitions by running the audit mode against a rubric covering frontmatter formatting, name uniqueness, description length, and system prompt checks. It also requires human judgment for nuanced aspects like role and lane.

What is the best way to write a new Claude Code subagent definition?

The best way to write a Claude Code subagent definition is to scaffold it using predefined guidelines for best practice and structure. This ensures proper scoping for roles, lane, and tool requirements.

How does subagent definition review work for mechanical and judgment criteria?

Subagent definition review works by applying automated checks for mechanical criteria like frontmatter formatting and name uniqueness, while requiring human judgment to evaluate nuanced aspects such as description, role, and lane.

Can I use a rubric to check my Claude Code subagent frontmatter and system prompts?

Yes, you can use a comprehensive rubric to check Claude Code subagent frontmatter formatting, description length, and system prompts. The automated mechanical checks ensure your definitions adhere to structural best practices.

What are the limitations of automated subagent definition audits?

The limitation of automated subagent definition audits is that they only cover mechanical criteria like frontmatter and naming. Nuanced aspects involving description quality, role definition, and lane assignment require human judgment to evaluate properly.

Do I need an existing subagent file to start a Claude Code audit?

Yes, you need an existing subagent definition file to start a Claude Code audit. You can initiate the audit process by running the audit mode with init against a specific file path like './agents/code-reviewer.md'.