{
  "markdown": "# skills\n\nA collection of reusable **agent skills** (Agent Skills format). Each skill is a self-contained\nfolder under `skills/<name>/` with a `SKILL.md` plus its own `scripts/`, `tests/`, and\n`references/`.\n\n## What is a skill\n\nA skill is a `SKILL.md` whose YAML frontmatter declares a `name` and a `description` (the trigger\nsurface an agent matches against), and whose body progressively discloses supporting `scripts/`,\n`references/`, and `assets/`. An agent loads the lean body first and pulls in depth only when\nneeded. See the\n[Agent Skills documentation](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview).\n\n## Catalog\n\n| Skill              | What it does                                                                                                                                            | Docs                                         |\n| :----------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------- |\n| `decision-records` | Draft, promote, archive, and supersede ADR-style decision records; keeps `INDEX.md` and cross-links generated and validated via `scripts/decisions.py`. | [SKILL.md](skills/decision-records/SKILL.md) |\n\n*Adding a skill? Add a row here — this catalog is maintained by hand.*\n\n## Using a skill\n\nTwo steps: install the skill into your agent, then (for `decision-records`) adopt it in a repo.\n\n### 1. Install it\n\nUse the [`skills` CLI](https://github.com/vercel-labs/skills) — no clone needed. Choose\nproject-local or global, and pass each agent you use with `-a`:\n\n```sh\n# project-local (committed with the repo)\nnpx skills add skymavis/skills@decision-records -a claude-code -a codex\n\n# global — available across all your projects\nnpx skills add skymavis/skills@decision-records -g -a claude-code\n```\n\nThis drops the skill into each agent's skills directory — `.claude/skills/` for Claude Code,\n`.agents/skills/` for Codex (`~/…` with `-g`). See the\n[supported-agents table](https://github.com/vercel-labs/skills#supported-agents) for the exact path\nper agent, then reload skills in your agent to pick it up.\n\n> No CLI? Point an agent harness straight at `skills/<name>/`, or copy that folder into a project's\n> `.claude/skills/`.\n\n### 2. Adopt it in a repo\n\n`decision-records` tracks decisions inside whatever repo you point it at. The easiest way: **ask\nyour agent to \"set up decision records in this repo\"** — it knows where its own skill scripts live.\nOr run the bundled tool by hand from the repo you want to track:\n\n```sh\npython <skills-dir>/decision-records/scripts/decisions.py install   # <skills-dir> = your agent's, e.g. .claude/skills\n```\n\nIt scaffolds `docs/decisions/`, generates the index, adds a pre-commit check, and drops a human\n`README.md` + an agent-facing `AGENTS.md` so the repo (and its agents) know the convention.\n\n## Layout\n\n```\nskills/                           # repo root\n├── README.md                     # this file — orientation + catalog\n├── AGENTS.md                     # rules for agents authoring/maintaining skills here\n├── CONTRIBUTING.md               # the skill-authoring guide + dev loop\n├── scripts/validate_skills.py    # the SKILL.md contract validator (source of truth)\n├── template/skill-name/          # copy this to start a new skill\n├── .github/workflows/ci.yml      # validate all skills + per-skill pytest matrix\n└── skills/\n    └── decision-records/         # a skill: SKILL.md + scripts/ + references/ + templates/ + tests/\n```\n\n## Develop locally\n\nSkills target Python 3.12+ and prefer the standard library. To author a skill and run the dev loop\n(set up, validate → test → lint), see [CONTRIBUTING.md](CONTRIBUTING.md); for the rules, see\n[AGENTS.md](AGENTS.md).\n\nThis README is orientation only — it does not restate any skill's mechanics. Each `SKILL.md` is the\nsource of truth for its own skill.\n",
  "bytes": 3974,
  "sha": "2ccd2f754f4ba21fd7a981e746727021dccd0618968bad7b57e5f4eebf5f76f2",
  "repo_slug": "skymavis/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_skymavis_skills_decision_records_29dfc822/readme"
}