Files

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

## Why

Two issues were found in `validate-provenance.sh` by `/skill-audit`:

1. `find_plugin_root` only walked up looking for bare `plugin.json`, missing
   the `.claude-plugin/plugin.json` layout used by kyberforge plugins — matching
   the logic already present in `validate.sh`.

2. Check numbers in `--help` and inline comments had a gap (0,1,2,4,5,6) from
   a previously removed check, making the numbering confusing to readers.

## Implementation Notes

Check numbers renumbered sequentially 0–5 in both the `--help` output block
and the inline `# --- Check N:` comments. The `find_plugin_root` condition now
mirrors the `detect_scope` function in `validate.sh`.

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

2026-07-04 11:33:03 +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

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

2026-07-04 11:23:05 +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