Files

Defame1297 bbb0dcd21a fix(lint): flatten multi-line frontmatter descriptions before Vale runs

Vale's text.frontmatter.description scope silently stops matching once
the description is a YAML block scalar spanning 2+ physical lines —
the style used by most skills/agents in this repo. scripts/vale-wrap.sh
flattens the description to one line in a scratch copy (preserving the
repo-relative path and total line count) before invoking real vale, and
both audit skills plus the pre-commit hook now call it instead of vale
directly. Also tightens the pre-commit hook's file glob to single path
segments so it can't cross into docs/research examples or asset
templates the way the audit skills' scoped invocations already avoid.

Addresses PR #85 review feedback.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FxG5T8EJDgkABXxuneuFfn

2026-08-08 20:20:58 +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): broaden audit self-triggers, plug factory gaps

2026-07-05 09:34:59 +00:00

tests

fix(agents): relocate provenance sources.md outside agents/ dir

2026-07-05 09:01:06 +00:00

README.md

fix(agents): relocate provenance sources.md outside agents/ dir

2026-07-05 09:01:06 +00:00

SKILL.md

fix(lint): flatten multi-line frontmatter descriptions before Vale runs

2026-08-08 20:20:58 +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 sources.md at the plugin root), 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 `sources.md` (plugin root)
`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