release-guard — Claude Code skill: release checks before merge
release-guard is a Claude Code skill that checks a repository before merge or release, comparing documented commands with package.json and architecture notes with current code paths.
MIT ★ 1,198 updated 2026-10-23
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill release-guard -a claude-codeWhat release-guard does
Point it at the repo before a merge or a release and you get a pass/fail report with file references you can open. It starts by matching the commands written in the docs to the ones package.json defines. From there it compares the architecture write-up with the paths the code uses today, and confirms the safety controls are still written down and still enforced.
The focus areas come from Claude-Code-Agent-Monitor itself: how hooks flow and what happens when one fails, the lifecycle rules for sessions and agents, the MCP safety gates and the host setup steps, and whether the troubleshooting section still tells the truth. On a project with no hooks or MCP wiring, several of those items have nothing to attach to.
A checklist ships with the skill at references/release-checklist.md, and the run follows it. For Claude the file lands in ~/.claude/skills/release-guard/SKILL.md; for Codex it goes to .agents/skills/release-guard/SKILL.md.
What it helps with
- match documented commands against
package.jsonbefore a merge - catch architecture docs that drifted from real code paths
- confirm the safety controls are still documented and on
- get a pass/fail report with file references instead of vague notes
- walk the hook and session-lifecycle items
Example prompts for the agent
- Run release-guard on this repo and give me the pass/fail report with file references.
- Use the release-guard skill to check whether the docs commands match
package.json. - Go through
references/release-checklist.mdand tell me where the architecture docs and the code disagree.
How to install release-guard
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill release-guard -a claude-code2Manually: put the files in place
~/.claude/skills/release-guard/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/release-guard/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill release-guard -a codex2Manually: put the files in place
.agents/skills/release-guard/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill release-guard -a cursor2Manually: put the files in place
.cursor/skills/release-guard/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor .agents/skills/release-guard2Manually: put the files in place
.github/skills/release-guard/SKILL.md1Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill release-guard -a gemini-cli2Platform CLI
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path .agents/skills/release-guardManually: put the files in place
.devin/skills/release-guard/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about release-guard
How do I install release-guard in Claude Code?
Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill release-guard -a claude-code. The skill file ends up at ~/.claude/skills/release-guard/SKILL.md.
What does release-guard do?
It compares the docs and scripts with what the repo actually contains: commands against package.json, the architecture write-up against code paths, the safety controls against what is enabled. Each item comes back as pass or fail with a file reference.
Where does the checklist live?
Inside the skill, at references/release-checklist.md. The run follows that file.
Source text
SKILL.md · MIT
--- name: release-guard description: Run release-readiness checks for this repository. Use when validating docs, scripts, verification coverage, and operational safety before merge or release. --- # Release Guard Skill ## Workflow - Check command consistency across docs and `package.json`. - Verify architecture docs align with current code paths. - Validate that safety controls are still documented and enforced. - Report pass/fail with concrete file references. ## Focus areas - Hook flow and failure behavior. - Session/agent lifecycle semantics. - MCP safety gates and host setup instructions. - Troubleshooting accuracy. ## References - `references/release-checklist.md`
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor