setup
/setup
Build or extend the team's shared rules skeleton (docs/rules), local CLAUDE.md and .gitignore from a repo fingerprint and a short interview. Use for "set up devkit", "make a dev rules skeleton", "add CLAUDE.md".
- Author
- JQ-WCoding ↗
- Repository
- devkit ↗
- Licence
- MIT
- Last repository change
- 13.11.2026
Assessment and security
- Files in this package
- 7
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/check_docs.py, scripts/scan_repo.py
What it does and when to use it
Build or extend the team's shared rules skeleton (docs/rules), local CLAUDE.md and .gitignore from a repo fingerprint and a short interview. Use for "set up devkit", "make a dev rules skeleton", "add CLAUDE.md".
Triggers from the description
Arguments
/setup [repo path]
Original author description
Build or extend the team's shared rules skeleton (docs/rules), local CLAUDE.md and .gitignore from a repo fingerprint and a short interview. Use for "set up devkit", "make a dev rules skeleton", "add CLAUDE.md".
How it works
- 0. Check the target
- 1. Collect the fingerprint
- 🛑 A. Interview
- 🛑 B. Setup plan approval
- 2. Write
- 3. Check
- 4. Report
SKILL.md preview
---
name: setup
description: Build or extend the team's shared rules skeleton (docs/rules), local CLAUDE.md and .gitignore from a repo fingerprint and a short interview. Use for "set up devkit", "make a dev rules skeleton", "add CLAUDE.md".
argument-hint: "[repo path]"
---
# devkit base setup
Follow [method.md](references/method.md): shared source of truth `docs/rules/` + local router `CLAUDE.md`, short table-first style, policies that go into every project. Fill rule-table rows only from the fingerprint and user answers; write nothing without evidence.
| Reference | When |
|---|---|
| [method.md](references/method.md) | At the start |
| [interview.md](references/interview.md) | 🛑A |
| [templates.md](references/templates.md) | Step 2 |
Run the scripts (no need to read them). Put their output in the scratchpad.
## 0. Check the target
- Check the repo root (argument or current directory), current branch and working-tree state. If it is not a git repo, ask whether to proceed without history.
- If `CLAUDE.md` or `docs/rules/` already exists, this is **extend** mode. Treat the existing docs as the source of truth and add only missing files and sections. Never overwrite.
- If `README.md`, `CONTRIBUTING.md`, `AGENTS.md`, `.cursorrules`, `.github/copilot-instructions.md` or install docs exist, read them as evidence (README often has run commands, ports and access paths). Do not delete or move them.
## 1. Collect the fingerprint
```bash
python3 -I "${CLAUDE_PLUGIN_ROOT}/skills/setup/scripts/scan_repo.py" <repo root> --out <scratchpad>/fingerprint.json > <scratchpad>/fingerprint.md
```
From `fingerprint.md` use only what this step needs: Layout (sub-projects), Runtime environment (versions, profiles, ports, proxies), CI, DB type, Existing rules and AI config, `.gitignore` and Tracked docs/ files count, Code style, Git (remote host, branches, Merge targets, commit convention, trailers). For environment facts not in the fingerprint, read config files, CI and scripts directly and record each file read in the "Evidence files" table of `decisions.md`.
If "Possible plaintext secrets" appears, report the locations only. Never print the values or copy them into docs.
## 🛑 A. Interview
Ask with AskUserQuestion only the [interview.md](references/interview.md) items the fingerprint did not settle (4 questions per call, 2–3 calls). For environment values, show what the fingerprint found and ask only whether it is right. Record answers in `<scratchpad>/decisions.md`.
## 🛑 B. Setup plan approval
Show everything at once and get approval. Create no files in the repo before approval.
- Files to create, one line each. State that layer docs hold fact rows only (applies-to path, language, runtime, aliases, reference files) and that rule rows are added later by `devkit:suggest-skills`
- Whether to create an onboarding guide (`docs/guide/`) and its step list
- Lines to add to `.gitignore` (or "no change" and why if all are present) and the fingerprint's Tracked docs/ files count. Run `git check-ignore -v <path>` for every planned path — if a file meant to be shared is ignored, add it to the allow list or rename it to match an existing allowed name
- Whether repo-wide file checkers (nohttp, license headers, markdownlint, spell check, etc. — find them in CI and build config) also apply to the new docs, and if so, that the docs will follow those rules
- Settings file: the ".claude/settings.json" section of [templates.md](references/templates.md) — `attribution` or `DEVKIT_AI_TRAILER` depending on the AI attribution answer. If the team-devkit answer is yes, `.claude/settings.json` (no install keys; each teammate installs devkit); if no, `.claude/settings.local.json`
- In extend mode, what will be added to each existing file
## 2. Write
Order: `docs/rules/` (README → common → git → environments → layer docs) → `docs/guide/` (if created) → `CLAUDE.md` → `.gitignore` → `.claude/settings.json` or `.claude/settings.local.json`.
- Use [templates.md](references/templates.md) as the skeleton. Fill `{{…}}` slots from the fingerprint and answers; delete the whole row when there is no evidence.
- Write environment values with their source (link to the config file) and add "as of" and "checked scope". Values the user confirmed get "user confirmed"; otherwise "from config files · not verified by running or connecting". Values with no evidence at all are `unverified`. For credentials, write only how they are delivered.
- Only add to existing files with Edit, preserving line endings (CRLF/LF).
- Do not commit. If asked, use `devkit:commit`.
## 3. Check
```bash
python3 -I "${CLAUDE_PLUGIN_ROOT}/skills/setup/scripts/check_docs.py" <repo root>
```
It checks `CLAUDE.md`, `docs/rules`, `docs/guide`, `.claude/agents` and `.claude/skills`. ERROR: broken links, secret-shaped values, unfilled `{{…}}`, agent frontmatter. WARN: inline-code identifiers with no evidence in the repo, broken links from the root README into `docs/rules` or `docs/guide`, length.
- Fix every `ERROR` and run again.
- For a no-evidence identifier WARN, check whether it was copied from another project or is a typo, and fix it. If it is an intended external name (a tool or standard in use), rerun with `--allow <identifier>` and report why.
- Check by hand: does `CLAUDE.md` only link to rules instead of copying them, are there no general-knowledge rows, can every row's evidence be found in `fingerprint.md` or `decisions.md`?
## 4. Report
Report files created or changed, interview decisions, check results and remaining WARNs, `.gitignore` changes and `unverified` environment values. Then suggest `devkit:suggest-skills` in one line as the next step (pinpoint rules, skills and agents for this repo).
Files in this package (7)
- SKILL.md 6 KB
- evals/evals.json 2 KB
- references/interview.md 5 KB
- references/method.md 6 KB
- references/templates.md 16 KB
- scripts/check_docs.py 9 KB
- scripts/scan_repo.py 34 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · JQ-WCoding/devkit | 100 | MIT |
| HwangSlater/harness-fit | 100 | MIT |
| nesquikm/dev-process-toolkit | 100 | MIT |
| userKael/rastro | 100 | MIT |
| als-apg/osprey | 100 | BSD-3-Clause |
| dedujeong/gemba | 100 | Apache-2.0 |
| eigenwise/eigenwise-toolshed | 100 | MIT |
| awrshift/agent-memory-kit | 100 | MIT |
| lifecycle-innovations-limited/claude-ops | 100 | MIT |
Database snapshot: 13.11.2026 · package version 33209da36e35 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100setup-rules
Install devkit coding rules to ~/.claude/rules/ for Claude Code language-specific auto-activation. Use when the user explicitly asks to set up devkit rules, install language rules, or run /devkit:setup-rules. One-shot installer with side effects (writes to ~/.claude/rules/) —… - 100configure-gitignore
Manage .gitignore's Claude Code block — worktrees, scheduled-task lock, local settings. Use when onboarding a repo or .gitignore lacks Claude entries. - 100gitignore-builder
Build and merge .gitignore files using github/gitignore templates with smart project detection. Use when the user asks to "create gitignore", "build .gitignore", "add gitignore templates", "set up gitignore", "update gitignore", or requests "/gitignore". Also trigger when… - 100setup-gitignore
Initialize or idempotently revise the repo's .gitignore by composing gitignore.io templates, AI-tooling/IDE patterns, and confirmed noise from git status. Use when the user says "set up gitignore", "fix gitignore", or untracked files keep appearing in git status. - 100new-project
Scaffold a new project directory for a chosen stack: git init, a CLAUDE.md with the real build and test commands, a Makefile with test and lint targets, a lint-on-edit hook, a .gitignore, secret scanning and the docs/ skeleton the other /wf skills write into. Use for 'start a… - 100new-project
Set up a new project, or bring an existing one without the basics up to standard - personal git identity, CLAUDE.md, tests from day one, CI, README with a status line, .gitignore for secrets. Use when the user starts a new repo or project, says "set up", "bootstrap", "start a…