skill-align — Skill Inventory & Docs Alignment Audit
Treats the Lattice repo's skills/ directory as the source of truth and audits then fixes documentation drift across README, docs/, PROJECT.md, CLAUDE.md and GitHub issue templates.
Dev & CodingIntermediate★ 194⑂ 13AI score 7/10Last updated: Sep 7, 2026
What it does
- Reads the
skills/tree from disk on every run to build a live inventory of atoms, molecules and refiners (explicitly refuses to rely on prior knowledge). - Audits, in order: README,
docs/how-it-works.md,docs/configuration.md,docs/practical-guide.md,PROJECT.md,CLAUDE.md, and.github/ISSUE_TEMPLATE/*.yml. - Produces a consolidated findings report tagged
[GAP],[STALE]or[WRONG], asks for approval, then applies fixes in a single edit pass per file. - Validates the error-prone refiner → atom → molecule consumption chain by cross-checking each SKILL.md and its Config Resolution (only
review-refineris legitimately consumed by a molecule directly). - Ends with a verification
grepthat must return no output, plus an optional deploy step via./tools/install.sh.
Who it's for
- Maintainers and contributors to the Lattice framework repository.
- Project owners who must repeat one skill/plugin catalog across docs and issue templates.
- Developers who want a reusable pattern for auditing "code changed, docs didn't" drift in their own repo.
Examples
- After adding a new atom, say "align docs" → it flags
[GAP]entries for the how-it-works inventory table and the bug_report.yml dropdown, then fills them in. - After renaming a skill → every lingering old name is reported as
[STALE], and the closing grep proves no references remain. - When a doc claims a refiner is "consumed by the molecule" → it raises
[WRONG]and rewrites it with the actual consuming atom.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/techygarg/lattice/HEAD/dev-skills/skill-align/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the dev-skills/skill-align folder from the GitHub repo techygarg/lattice into my ~/.claude/skills/skill-align/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/techygarg/lattice.git && mkdir -p ~/.claude/skills && cp -r lattice/dev-skills/skill-align ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/techygarg/lattice.git - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r lattice/dev-skills/skill-align ~/.claude/skills/ - Confirm bundled files came along (e.g.
references/audit-checklist.md):ls ~/.claude/skills/skill-align - Important: the skill assumes the Lattice repo layout (
skills/,docs/,PROJECT.md,.github/ISSUE_TEMPLATE/). Launch Claude Code from that repo root. - In Claude Code, ask for "align docs" or "skill align" to start the audit.
- To reuse it elsewhere, edit the document path list and inventory rules to match your own project structure.
View source on GitHub ↗License: MIT