Files
holocron/plugins/core/skills/provider-adapter-author
Defame1297 1c3af75642 fix(core): make --no-import-syntax actually change the adapter validation
Both branches of the flag reduced to the same expression, so the option was
inert: a caller who asked for the no-import form got the import-form check
anyway and a passing result that meant nothing.

Two further defects in the same validator: --max-lines failed silently when
given a value it could not use, and the Fix text told the agent to edit
AGENTS.md when the offending content is the provider adapter's. The boundary
clauses now name the operation being routed rather than the file type, which
was ambiguous where both skills touch the same file.

Addresses #115.
2026-08-31 08:01:45 +00:00
..

provider-adapter-author

Convert a target repo's provider-specific instruction file (CLAUDE.md, .cursor/rules, copilot-instructions.md, etc.) into a thin adapter over AGENTS.md.

What it does

Detects a provider-specific AI instruction file in a target repo, diffs it against the repo's AGENTS.md, and rewrites it down to a minimal reference — an @AGENTS.md-style import for providers that support one, or a text pointer for those that don't — plus only genuinely provider-specific additions. Self-validates its own output with a bundled deterministic script (no LLM judgment, no separate audit skill) before finishing.

Before you start

The target repo must already have an AGENTS.md. If it doesn't, run agentsmd-author first — this skill never creates or edits AGENTS.md itself.

Usage

/provider-adapter-author

Provide the path to the provider-specific file to convert (and the target repo root, if not inferable). Can be invoked directly, or composed into by agentsmd-author when it detects an existing provider file with content overlapping AGENTS.md.

Files

File Purpose
SKILL.md Skill instructions for agents
references/provider-matrix.md Loaded at Step 1 before searching, unless the target is already a known root CLAUDE.md: known files per provider, which ones resolve a cross-file import, and the validator flag each needs
references/sources.md Provenance record — the in-repo ADR precedent this skill's design is modeled on
scripts/validate-adapter.sh Self-check gate: reference to AGENTS.md present, no excessive duplication, adapter stays thin
scripts/README.md Directory documentation for scripts/
tests/README.md (source-only) Bats test dependency and run instructions
tests/validate-adapter.bats (source-only) Bats test suite for scripts/validate-adapter.sh

Rows marked (source-only) exist in the authoring source (.apm/skills/provider-adapter-author/) but are not present in an installed plugin: the repo's scripts/sync-plugin-content.sh strips <category>/<name>/tests when it generates the flat mirror, because these are dev-time fixtures no plugin host needs to discover (ADR-0017). Run them from a repo checkout, not from an install.