# core

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

## Install

apm is the only supported install path (ADR-0024). Declare this package in the consuming project's `apm.yml`:

```yaml
dependencies:
  apm:
    - git: git@git.rkdr.net:Defame1297/holocron.git
      path: plugins/core
```

Then:

```bash
apm install
```

The entry above is unpinned and tracks the remote's default branch — add `ref: <tag>` to pin a release. Registering the catalogue instead (`apm marketplace add git@git.rkdr.net:Defame1297/holocron.git --name holocron`) gets you the `core@holocron` short name, but writes to `~/.apm/marketplaces.json` at user scope; the git+path object needs nothing beyond the manifest.

**Native plugin installs do not work.** This package ships no per-plugin manifest and no flat content directories, so a host that installs it natively gets zero skills — and Claude Code raises no error while doing it (ADR-0024).

## Contents

| Component | Path | Description |
|---|---|---|
| Skills | `.apm/skills/` | Slash commands available after install |

`.apm/` is the authoring source and the only thing apm deploys (ADR-0024).

## 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