Monitor CI
nrwl/nx
Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.
A skill your agent uses to check a feature's code against the charter's architecture rules — dependency layering, cycles, forbidden patterns, file naming, file size.
Install Arch Check
$ npx skills add swingerman/engineer --skill arch-check -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install swingerman/engineer arch-check --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineer/skills/arch-check .claude/skills/arch-check && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "arch-check" agent skill from https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-check into .claude/skills/arch-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arch-check", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-checkType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add swingerman/engineer --skill arch-check -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install swingerman/engineer arch-check --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineer/skills/arch-check .agents/skills/arch-check && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "arch-check" agent skill from https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-check into .agents/skills/arch-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arch-check", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add swingerman/engineer --skill arch-check -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install swingerman/engineer arch-check --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineer/skills/arch-check .cursor/skills/arch-check && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "arch-check" agent skill from https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-check into .cursor/skills/arch-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arch-check", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/swingerman/engineer.git --path engineer/skills/arch-check--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add swingerman/engineer --skill arch-check -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install swingerman/engineer arch-check --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineer/skills/arch-check .gemini/skills/arch-check && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "arch-check" agent skill from https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-check into .gemini/skills/arch-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arch-check", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install swingerman/engineer arch-checkInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add swingerman/engineer --skill arch-check -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineer/skills/arch-check .github/skills/arch-check && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "arch-check" agent skill from https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-check into .github/skills/arch-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arch-check", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add swingerman/engineer --skill arch-check -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install swingerman/engineer arch-check --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/swingerman/engineer.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineer/skills/arch-check .opencode/skills/arch-check && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "arch-check" agent skill from https://github.com/swingerman/engineer/tree/master/engineer/skills/arch-check into .opencode/skills/arch-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "arch-check", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
arch-check- GitHub stars
- 154
- Token cost
- ~1k tokens
- SKILL.md length
- 485 words
- Files
- 1
- Skills in repo
- 27
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses to check a feature's code against the charter's architecture rules — dependency layering, cycles, forbidden patterns, file naming, file size.
- Works in 7 steps: Entry gate → Run the check → 5 — CRAP analysis → …
- Check a features code against the charters architecture rules — dependency layering
- SKILL.md covers When to use, Workflow and References
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Arch Check is an agent skill from swingerman/engineer. Use to check a feature's code against the charter's architecture rules — dependency layering, cycles, forbidden patterns, file naming, file size. Triggers — "/engineer.arch-check", "architecture check", "check architecture fitness", "does this follow the charter", "check layering".
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud. The repository describes itself as: Disciplined Agentic Engineering — a methodology kit for Claude Code: acceptance-test-first specs, explicit checkpoints, and autonomy you can actually leave running. The engineer… The licence is MIT.
When your agent uses it
- Check a features code against the charters architecture rules — dependency layering
- Forbidden patterns
- — /engineer.arch-check
- Architecture check
Example prompts
- “s code against the charter”
- “/engineer.arch-check”
- “architecture check”
- “/arch-check”
Workflow steps
7 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 32947eb. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
notion.so
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Arch Check loads about 1k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 485 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from swingerman/engineer at commit 32947eb, republished under its MIT licence (© swingerman). 485 words, ~1,030 tokens.
Download SKILL.mdSave it as
.claude/skills/arch-check/SKILL.md (or your agent's skills folder).- name
- arch-check
- description
- Use to check a feature's code against the charter's architecture rules — dependency layering, cycles, forbidden patterns, file naming, file size. Triggers — "/engineer.arch-check", "architecture check", "check architecture fitness", "does this follow the charter", "check layering".
arch-check
Run the charter architecture fitness check — Checkpoint 7 (Light Verify),
alongside crap-analyzer. Turns the charter's architectural vision from prose
into an objective gate: dae_arch.py reads the manifest's architecture: rules
and reports violations.
Read-only on the codebase — it reports, it does not fix.
When to use
Checkpoint 7, after the feature's code is implemented and refined. Also useful
as a standalone audit (--full) of an existing project.
Not for: change-risk analysis (crap-analyzer); artifact consistency
(consistency-check); fixing violations (that is a human/agent decision per
violation).
Workflow
Step 0 — Entry gate
Verify the prior checkpoint is complete: run
${CLAUDE_PLUGIN_ROOT}/scripts/dae_handoff.py <feature-dir> --through 6. On a
non-zero exit, stop and surface the gap to the human.
Verify branch hygiene: run ${CLAUDE_PLUGIN_ROOT}/scripts/dae_branch.py <feature-dir>.
On a non-zero exit, stop and surface the message to the human — switch
branches and re-invoke. The check honors the git.manual: true manifest
opt-out.
After the gate passes, show the pipeline breadcrumb: run
${CLAUDE_PLUGIN_ROOT}/scripts/dae_progress.py <feature-dir> and present its
output to the human — it shows where this checkpoint sits in the DAE pipeline.
The breadcrumb is advisory: a non-zero exit or a missing progress.md never
blocks the skill. Then create one TodoWrite todo per workflow step below. See
${CLAUDE_PLUGIN_ROOT}/references/progress-indicator.md.
Step 1 — Run the check
Run ${CLAUDE_PLUGIN_ROOT}/scripts/dae_arch.py <methodology-root> (add --full
for a whole-project audit). If it reports "no architecture: section", tell the
user the charter has no machine-readable architecture rules yet and stop.
Step 1.5 — CRAP analysis
CP7 Light Verify is arch-check plus crap-analyzer. If crap-analyzer hasn't
run on the current diff, run it now over the feature's changed code. Keep its
summary for the handoff: max CRAP, the offenders over
quality_thresholds.crap_max, and the command. It is external and writes no
handoff of its own, so this is where CP8's refinement-advisor reads it.
Show full SKILL.md (196 more words)Show less
Step 2 — Present violations
Group the violations by kind (layering first — it is the architectural-vision
core). For each, show file:line and the rule. Do not auto-fix.
Step 3 — Triage with the human
For each violation, the human decides: a real break (fix the code), or a rule
that no longer fits (amend manifest.architecture — and the charter prose).
dae_arch.py exiting non-zero means Checkpoint 7's architecture-fitness exit
criterion is unmet until the violations are resolved.
Step 3.5 — Runbook gate (if runbook.md exists)
If features/<slug>/runbook.md exists, check that every step blocking a
deploy-related AC is completed: true. If any blocking step is open while
its dependent AC is asserting met: true, surface it as a verification
gap and refuse to mark CP7 complete. The runbook's blocking_acs list is
the source of truth — see engineer/skills/plan/references/runbook-template.md.
Step 4 — Handoff
Emit a summary per ${CLAUDE_PLUGIN_ROOT}/references/handoff-summary.md.
checkpoint: 7; the exit_criteria block asserts the architecture-fitness
criterion with verified_by: tool and the dae_arch.py exit status as evidence,
and carries crap-analyzer's summary as a crap_results block (max_crap,
offenders: [{symbol, file, crap, coverage}], command). CP8's harden and
refinement-advisor read that block.
recommended_next: "/engineer.harden (CP8)".
References
- Foundation Design —
the
architecture:manifest section (§2); the Checkpoint Exit Contract (§8)
© swingerman, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in engineer/skills/arch-check of swingerman/engineer.
Open the folder on GitHubat commit 32947eb
Compare with similar skills
Arch Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Arch Check this skillswingerman/engineer | 154 | — | ~1k | Automated safety check: Pass | MIT | |
| Monitor CInrwl/nx | 29k | 5 repos | ~4.7k | Automated safety check: Pass | MIT | |
| Terraform and OpenTofu Guideagentscope-ai/QwenPaw | 35k | 6 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Vercel Optimize Auditvercel-labs/agent-skills | 32k | 8 repos | ~4.3k | Automated safety check: Pass | None | |
| Analyze GitHub Action Logswithastro/astro | 63k | 1 repos | ~1.3k | Automated safety check: Pass | Custom licence | |
| Docs Learn PR Previewnetdata/netdata | 81k | — | ~2k | Automated safety check: Pass | GPL-3.0 |
Similar skills
Terraform and OpenTofu Guide
agentscope-ai/QwenPaw
Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.
- Official
Vercel Optimize Audit
vercel-labs/agent-skills
Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.
- Official
Analyze GitHub Action Logs
withastro/astro
Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.
Docs Learn PR Preview
netdata/netdata
Use only when the user explicitly asks to build, run, preview, inspect, or validate learn.netdata.cloud locally using the contents of a PR or documentation branch before merge.
Repo Mirror Sources
netdata/netdata
Inspect Netdata-org source checkouts under NETDATAREPOSDIR, or set up and synchronize that mirror when requested.
More from swingerman/engineer
All 27 skills in this repoCrap Analyzer
swingerman/engineer
A skill your agent uses to produce a risk-based refactor + test plan for recently-changed code on a diff/branch/PR by computing CRAP (complexity × untested) on changed methods.
Atdd Mutate
swingerman/engineer
A skill your agent uses to add a third validation layer to the ATDD workflow — after acceptance tests verify WHAT and unit tests verify HOW, mutation testing verifies the tests actually catch bugs.
Fix
swingerman/engineer
A skill your agent uses to drive a bug fix from first report through close, with a "why didn't we catch it?" loop at the end.
Atdd
swingerman/engineer
A skill your agent uses to drive feature work through the Acceptance Test Driven Development workflow — Given/When/Then specs before code, a project-specific test pipeline, and two parallel test…
Harden
swingerman/engineer
Use after a feature passes Light Verify (CP7), to prove the tests actually catch bugs and, where the code warrants it, to formally check its invariants — Checkpoint 8.
Next
swingerman/engineer
Use at the start of a work session, or any time the question is "what should I pick up now" across the whole project.
Related
Categories
Questions about Arch Check
What does Arch Check do?
A skill your agent uses to check a feature's code against the charter's architecture rules — dependency layering, cycles, forbidden patterns, file naming, file size. Arch Check is an agent skill from swingerman/engineer. Use to check a feature's code against the charter's architecture rules — dependency layering, cycles, forbidden patterns, file naming, file size.
When should I use Arch Check?
Arch Check fits situations like: check a features code against the charters architecture rules — dependency layering; forbidden patterns; — /engineer.arch-check; architecture check.
How do I install Arch Check in Claude Code?
Run `npx skills add swingerman/engineer --skill arch-check -a claude-code`. Or copy the skill folder (engineer/skills/arch-check in swingerman/engineer) into .claude/skills/arch-check in your project. Claude Code loads it when a task matches its description.
How do I install Arch Check in Codex?
Run `npx skills add swingerman/engineer --skill arch-check -a codex`. Or copy the skill folder (engineer/skills/arch-check in swingerman/engineer) into .agents/skills/arch-check in your project. Codex loads it when a task matches its description.
Can I use Arch Check in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add swingerman/engineer --skill arch-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/arch-check, .gemini/skills/arch-check, .github/skills/arch-check and .opencode/skills/arch-check in your project.
What does Arch Check need to run?
SKILL.md names no scripts, command-line tools or credentials: Arch Check is instructions for the agent only.
Does Arch Check access the network?
SKILL.md names 1 domain. As links in the text: notion.so. This is read from the text; nothing was executed.
Is Arch Check safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Arch Check use?
Arch Check is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Arch Check use?
About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Arch Check?
Skills that share tags, products or a category with Arch Check: Monitor CI (nrwl/nx, 29k stars), Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 35k stars), Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars) and Analyze GitHub Action Logs (withastro/astro, 63k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Arch Check?
swingerman (a GitHub user) maintains it in swingerman/engineer, which has 154 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on September 23, 2026.
Source: swingerman/engineer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.