Klaussy init
A multi-agent context, rules, and hooks boilerplate generator. With a single command, it scaffolds conventions, namespaced skills, stack-appropriate settings, and interactive guardrails for seven major AI coding environments, matching each agent's native file formats and capability profiles.
npx -y skills add steph-dove/klaussy-agents --skill klaussy-initAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 11 stars11 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when the user wants to make this repository AI-agent-ready. Scaffolds per-agent conventions (CLAUDE.md / GEMINI.md / AGENTS.md / Cursor rules / Copilot instructions, path-scoped via klaussy-repo-conventions), repo-namespaced skills, settings, hooks, and a PR template for Claude Code, Gemini CLI, Cursor, Codex, GitHub Copilot, Google Antigravity, Cline, and Aider — and runs once per repo.
SKILL.md
4.2 KB, as published. Nobody here has run it
Klaussy init
Scaffold AI coding-agent boilerplate for the user's project by running klaussy. By default this covers all eight supported agents — Claude Code, Gemini CLI, Cursor, Codex, GitHub Copilot, Google Antigravity, Cline, and Aider — from a single shared set of conventions.
Steps
-
Confirm klaussy is available. Run
klaussy --version. If the command isn't found, install withpipx install klaussy(preferred) orpip install --user klaussy. Re-verify withklaussy --versionafterward. -
Detect the base branch. Klaussy will prompt interactively if not given, which blocks the agent. Pre-detect via
git branch --list dev develop main master | head -1and pass--base-branch <detected>. If none of those exist, fall back to whatevergit symbolic-ref refs/remotes/origin/HEADreturns, ormain. -
Run klaussy init. Pass through
$ARGUMENTSif the user supplied any (e.g.--force,--skip-enrich):klaussy init --base-branch <detected> $ARGUMENTSIf
.claude/skills/or./CLAUDE.mdalready exists, ask the user whether to pass--forcerather than assuming. The migration inklaussy initremoves legacy.claude/commands/*.mdfiles only if it owns them (via the.klaussy-versionmarker) — user-authored commands are left alone.Agent targets. By default klaussy scaffolds all eight supported agents — Claude Code, Gemini CLI, Cursor, Codex, GitHub Copilot, Google Antigravity, Cline, and Aider — from the same conventions. Each gets its native conventions file (e.g.
CLAUDE.md,GEMINI.md,AGENTS.mdfor Codex/Antigravity,.github/copilot-instructions.md,.cursor/rules/,.clinerules/conventions.md,CONVENTIONS.mdfor Aider), plus the bundled skills in its native skills directory and permissions — except Aider, which is conventions-only (it has no skills or hooks mechanism). To narrow to specific agents, pass--agents claude,gemini(any subset). If the user only uses Claude, suggest--agents claude. -
Verify output. The paths below are Claude Code's; each other selected agent gets the equivalent in its own dir (
.gemini/,.cursor/,.agents/for Codex,.github/for Copilot) plus its native conventions file. Confirm these landed:./CLAUDE.mdat the repo root (with project-wide content).claude/rules/<glob-stem>.mdfor each path-scoped rule bucket klaussy-repo-conventions detected (zero or more files; some repos won't have any).claude/skills/<repo>-<skill>/SKILL.mdfor 16 skills (review, precommit, plan, debug, implement, refactor, test, fix, pr, commit, explain, humanize, new-worktree, adr-generator, security-audit, slop-coded).claude/settings.json.github/PULL_REQUEST_TEMPLATE.md(only if the repo didn't already have one).gitignoreupdated with klaussy output exclusions
-
Report. Tell the user which skills were created (point at
<repo>-planand<repo>-reviewas the high-leverage ones), summarize what's inCLAUDE.mdand any.claude/rules/*.mdfiles, and suggest reviewing them before committing.
When NOT to use
- The repo is already klaussified at the same klaussy version —
klaussy initwill be a near-no-op; suggest theklaussy-updateskill instead if the user actually wants to refresh. - The user wants a different scaffold tool (cookiecutter, an org-internal generator) — klaussy targets Claude Code, Gemini CLI, Cursor, Codex, Copilot, Antigravity, Cline, and Aider, and may not fit other setups.
- The repo is empty or has no committed code yet — klaussy infers conventions from the existing code; an empty repo gets generic boilerplate that the user may want to defer until there's something to detect from.