Agent skill
init
Set up govctl in the current project. Installs the binary if missing, initializes governance structure.
Install this agent skill to your Project
npx add-skill https://github.com/govctl-org/govctl/tree/main/.claude/skills/init
SKILL.md
/init - Set Up Govctl
Set up govctl in the current project.
Outputs: Initialized governance structure, verified local setup, and a recommended next workflow.
Critical Rules
- This is a setup workflow, not an implementation workflow. Do not create work items or change product code here.
- Ask permission before installing
govctlwithcargo install govctl. - Prefer local
govctlif it is already available. When working in thegovctlrepo itself, prefercargo run --quiet --before installing a global binary. - Never edit governed files directly. Use
govctl init. - If setup succeeds and the user wants it recorded, hand off to
/commitrather than embedding raw VCS commands here.
Steps
1. Check for govctl binary
govctl --version
If you are working in the govctl repository itself, prefer:
cargo run --quiet -- --version
If that works, use cargo run --quiet -- <subcommand> for the rest of this workflow instead of installing a global binary.
If no usable local invocation exists, ask permission, then install it:
cargo install govctl
If cargo is also missing, tell the user to install Rust first: https://rustup.rs
2. Initialize the project
If gov/config.toml does not exist:
govctl init
If it already exists, skip — the project is already initialized.
3. Verify
govctl status
Show the user what was created and confirm everything is working.
Next Steps
- Use
/discussfor design work - Use
/specfor governance-only artifact maintenance - Use
/govfor implementation-bearing work - Use
/quickfor trivial non-behavioral cleanup
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
commit
Commit changes with govctl integration — check work item status, update journal or notes, and run govctl check
guard-writer
Write well-structured Verification Guards. Use when: (1) Creating a new guard, (2) Editing guard check commands or patterns, (3) User mentions guard, verification, or check
wi-writer
Write well-structured work items with proper acceptance criteria. Use when: (1) Creating work items, (2) Adding acceptance criteria, (3) User mentions work item, task, WI, or ticket
adr-writer
Write effective Architecture Decision Records. Use when: (1) Creating a new ADR, (2) Recording a design decision, (3) User mentions ADR, decision, trade-off, or alternatives
rfc-writer
Write well-structured RFCs with normative clauses. Use when: (1) Creating a new RFC, (2) Adding or editing RFC clauses, (3) User mentions RFC, specification, or normative requirements
decision-analysis
Stress-test a design decision with premortem/backcast analysis, then produce a risk-calibrated recommendation that maps to ADR fields. Use when: (1) Multiple competing architecture options, (2) Irreversible or high-risk design choices, (3) /discuss identifies a complex trade-off
Didn't find tool you were looking for?