Organizes project documentation into canonical docs/ domains and manages spec lifecycle.
npx skills add https://github.com/rogerznts/anvil --skill anvil-docs-rogerznts
Please help me install this Agent Skill. Skill: anvil-docs Source: https://github.com/rogerznts/anvil/tree/main/anvil/.claude/skills/anvil-docs Command: npx skills add https://github.com/rogerznts/anvil --skill anvil-docs-rogerznts
scaffold creates the canonical tree in a new project, adopt classifies and relocates an existing messy docs/ with duplicate detection, index regenerates docs/index.md, and archive promotes canonical artifacts and moves closed specs to docs/specs/archive/. - Merge guard: a PreToolUse hook blocks git merge and PR creation while a spec has unresolved tickets or is not yet archived, reading the spec from each branch's commit. - Validation scripts: validate.sh checks ship-readiness and canonical docs paths; find-dupes.sh detects duplicate content by hash, artifact identifier, and title. - Use Case: Adopting a brownfield project whose docs/ contains loose files, an old docs/adr/ layout, and duplicated stories—survey everything, get an approved move plan, and finish with a clean, indexed, duplicate-free tree. ## Quick Start Ask the assistant to run the anvil-docs skill to scaffold the documentation tree or adopt the existing docs folder in this repository.High-intent search queries and answers about installing and using this skill.
Use the adopt verb: it surveys every file, classifies each as conforming or non-conforming against canonical domains, runs duplicate detection, and presents a full move plan for approval before touching anything. Nothing is overwritten or deleted without explicit confirmation.
Run the archive verb after all tickets show Status: resolved and before opening the PR, on the same branch. It applies front-matter promote directives, moves the spec to docs/specs/archive/, and regenerates the index so the merge guard passes.
The guard blocks merge or PR creation when the branch's spec has tickets without Status: resolved or is not yet under docs/specs/archive/ in the commit. It reads specs from each branch's commit, so uncommitted changes do not count.
The find-dupes.sh script groups Markdown files by identical content hash, shared artifact identifiers like US-014 or ADR-003, and matching titles. It lists candidate groups and exits 1 when any are found, leaving the merge-or-keep decision to the user.
The branch is {type}/{NNN}-{name} while the folder is docs/specs/{NNN}-{type}-{name}; they are deliberately different strings. Always resolve between them by the numeric prefix, never by string equality.
ThorStarlordConfigure repository-specific agent skill settings for issue trackers, triage labels, and domain docs.
az9713Push the current feature branch and open a GitHub pull request with a structured body.
b12consultingOrganize project requirements and decisions within a specs/ folder.
The-Vibe-CompanyConfigures a repository's issue tracker, triage labels, and domain doc layout for engineering skills.