Files
holocron/plugins/core
Defame1297 a8cd5e881d fix(core): strip a BOM before the adapter import check, and split usage exits
Narrowing has_reference to bool(import_lines) meant a UTF-8 BOM hid the import
line, since the BOM is not \s: a CLAUDE.md whose first line is @AGENTS.md failed
with 'no reference to AGENTS.md' and was told to add the line already in front of
it. Decoding is now strict too, so a non-UTF-8 adapter gets an encoding
diagnostic instead of being mangled and then graded on the mangling.

Usage errors move to exit 2. They shared exit 1 with real findings, while the
skill tells the agent to fix any non-zero exit by editing the provider file.

The whole-line import rule is kept deliberately -- accepting an inline @AGENTS.md
would also accept one inside backticks, which is the silent-drop failure the
validator exists to catch -- and the message now says so.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EJJrm5YmacbwMdzZpXcoti
2026-08-31 19:46:07 +00:00
..

core

Skills for authoring and auditing a repo's AGENTS.md and the provider adapter files that defer to it.

Install

Claude Code:

claude plugin marketplace add <owner>/<repo>
claude plugin install core@<marketplace-name>

GitHub Copilot CLI:

copilot plugin marketplace add <owner>/<repo>
copilot plugin install core

Local (development):

# Claude Code
claude --plugin-dir ./plugins/core

# GitHub Copilot CLI
copilot plugin install ./plugins/core

Contents

Component Path Description
Skills .apm/skills/ → skills/ Slash commands available after install

.apm/ is the authoring source; skills/ is the generated mirror plugin hosts scan (ADR-0017).

Skills

Skill Description
agentsmd-author Create or update a repo's AGENTS.md by exploring real build/test/lint conventions; supports nested monorepo placement and hands off to agentsmd-audit and provider-adapter-author
agentsmd-audit Audit a repo's AGENTS.md for embedded secrets, structural completeness, and drift; produces a findings report
provider-adapter-author Convert a provider-specific instruction file (CLAUDE.md, .cursor/rules/*.mdc, copilot-instructions.md, etc.) into a thin adapter that defers to AGENTS.md

Author

Defame1297