Files
holocron/plugins/kyberforge/skills/agent-audit/references
Defame1297 afadaae793 fix(lint): reword the two Vale errors this branch put where nothing lints
`Kyberforge.SentenceOpenerThereIs` is `level: error`, but `.vale.ini` scopes the
style to `[**/SKILL.md]`, so no hook can see a violation in `references/`. This
branch's own remedy — move prose out of the body into `references/` — is what
carried these two there:

- `provider-adapter-author/references/provider-matrix.md:31`
- `agent-audit/references/finding-criteria.md:95`

Both confirmed by copying the file to `SKILL.md` and running the audit's own
`vale-wrap.sh`: 1 error each before, 0 after. Reworded to name the subject
directly, which is what the rule asks for.

Five further occurrences exist in `references/` files already on `main`. Those
are the pre-existing corpus, not this branch's regression, and stay with #117 —
which is the real fix: widen the Vale scope so the gate can see this class at
all, and make the wrapper distinguish "0 alerts in 1 file" from "0 files
matched".

Source and generated mirror move together so the commit passes
`check-plugin-content-sync` standalone.

Refs: #117

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ktx4QJzTXZtw35m6T9WhcK
2026-09-01 13:32:31 +00:00
..

source_keys
source_keys

references/

Additional documentation agents load on demand.

Files

File Purpose
finding-criteria.md Every dimension's FAIL and SUGGESTION criteria — the one Step 3 file read on every run; it decides which rubrics below are worth loading.
description-quality.md Rubric for the description dimension — why the description is the expensive part, the hand-invoked contract, the three-part shape, indirect triggers, and near-miss exclusions.
body-and-delegation.md Rubric for the body, delegation and comment-discipline dimensions — the core test, the delegation FAIL, why agents take no body word gate, and what an agent body is for.
scope-plugin-apm.md Contract for a single vendor-neutral .apm/agents/<name>.agent.md file — allowlist, dimension routing, and the dimensions that do not apply.
scope-project-user.md Contract for a Claude Code / Copilot file pair — counterpart derivation, provider field rules, and pair consistency.
validation-scripts.md Loaded only when a Step 1 script fails or cannot run — scope-detection walk-up, manual fallback checks, and known script failures.
field-inventory.md Authoritative field lists, read as data by validate.sh: valid CC and Copilot agent fields, and the vendor-neutral plugin/APM allowlist.
sources.md Research provenance records for skill content. Load only when tracing the origin of a specific rule or field constraint.