Files

Defame1297 19f7fde5e1 refactor(factory): align agent-author and agent-audit with skill-author pattern

- agent-author: convert template comments from YAML (#) to HTML (<!-- -->)
  - Easier to spot and distinguish from functional comments
  - Add explicit "Delete template comments before shipping" reminders
  - Update SKILL.md Steps 2-3 with removal instruction

- agent-audit: add comment-discipline check
  - Flag excessive frontmatter documentation comments as padding
  - Mirrors skill-audit's body-discipline principle
  - Update coverage line to include comment-discipline dimension

This ensures agents follow the same comment-cleanup discipline as skills,
preventing template documentation from shipping with agent definitions.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

2026-07-04 15:23:04 +00:00

references

feat(kyberforge): improve agent-audit skill with platform-accurate checks and description quality reference

2026-07-04 11:10:32 +00:00

scripts

fix(kyberforge): address agent-audit audit findings in validate-provenance.sh

2026-07-04 11:33:03 +00:00

tests

fix(kyberforge): apply audit findings to agent-audit skill

2026-07-04 11:23:05 +00:00

README.md

feat(kyberforge): improve agent-audit skill with platform-accurate checks and description quality reference

2026-07-04 11:10:32 +00:00

SKILL.md

refactor(factory): align agent-author and agent-audit with skill-author pattern

2026-07-04 15:23:04 +00:00

README.md

agent-audit

Audits a Claude Code and Copilot agent definition file pair for correctness and quality.

What it does

Accepts either file in a CC .md / Copilot .agent.md pair, derives the counterpart automatically, and validates both. Runs structural checks via validate.sh (required fields, kebab-case name, no placeholders, no CC-only fields in the Copilot file, silently-ignored fields at plugin scope), provenance chain validation via validate-provenance.sh (checks source_keys against agents/sources.md at plugin scope), then qualitative checks on description phrasing and system prompt quality. Produces a compact findings report in the same format as skill-audit.

Usage

/agent-audit

Pass the path to either agent file as the argument.

Files

File	Purpose
`SKILL.md`	Skill instructions for agents
`references/README.md`	Directory documentation for references/
`references/description-quality.md`	Qualitative guide for borderline description findings
`references/field-inventory.md`	Authoritative list of valid CC and Copilot agent fields
`references/sources.md`	Research provenance for skill content
`scripts/README.md`	Directory documentation for scripts/
`scripts/validate.sh`	Structural validation script for agent file pairs
`scripts/validate-provenance.sh`	Provenance chain validation script for agent pairs against `agents/sources.md`
`tests/README.md`	Bats test dependency and run instructions
`tests/validate.bats`	Bats tests for validate.sh
`tests/validate-provenance.bats`	Bats tests for validate-provenance.sh