init
/init
Set up code-guardrails in the current project. Creates guardrails.json and shield.json for the detected stack (Flutter/Dart, Python, Node, Swift) and installs the code shield's git hooks. Use when the user asks to set up, enable, install or initialize the guardrails, the guard hooks or the code shield in a project.
- Author
- alizici ↗
- Repository
- claude-code-guardrails ↗
- Licence
- MIT
- Last repository change
- 07.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Set up code-guardrails in the current project. Creates guardrails.json and shield.json for the detected stack (Flutter/Dart, Python, Node, Swift) and installs the code shield's git hooks. Use when the user asks to set up, enable, install or initialize the guardrails, the guard hooks or the code shield in a project.
Original author description
Set up code-guardrails in the current project. Creates guardrails.json and shield.json for the detected stack (Flutter/Dart, Python, Node, Swift) and installs the code shield's git hooks. Use when the user asks to set up, enable, install or initialize the guardrails, the guard hooks or the code shield in a project.
How it works
SKILL.md has no level-two headings · 32 lines, 343 words
SKILL.md preview
---
name: init
description: Set up code-guardrails in the current project. Creates guardrails.json and shield.json for the detected stack (Flutter/Dart, Python, Node, Swift) and installs the code shield's git hooks. Use when the user asks to set up, enable, install or initialize the guardrails, the guard hooks or the code shield in a project.
---
# Set up the guardrails in this project
The plugin's hooks do nothing in a project until it has a `guardrails.json`. This skill creates it.
1. From the project root, run `guardrails-init` in Bash. It detects the stack, writes a starter
`guardrails.json` and `shield.json`, and installs the code shield's git hooks (`pre-commit` and
`reference-transaction`; an existing hook is backed up, never overwritten). It never overwrites an
existing `guardrails.json` or `shield.json`. Add `--no-git-hooks` if the user doesn't want git hooks.
It ends by running each gate once: `pass · armed` means the gate now blocks regressions; `RED on the
current tree` means the test command fails before anything was changed (often a placeholder test
script or no tests yet). A red gate warns instead of blocking until it passes once, so don't try to
make it pass: tell the user, and fix the command in step 2 if it is simply wrong.
2. Read the new `guardrails.json` and check it against the project:
- `gates`: does each test command match how this project really runs its tests (look at CI config,
Makefile, package scripts, melos/workspace setup)? Monorepos usually need one gate per package with
its own `on` globs and a `cd <package> && ...` command.
- `generated.paths`: every code-generator output (build_runner, protobuf, l10n, OpenAPI clients).
- `roles`: where tests and production code really live.
Propose the changes to the user before making them. From now on, edits to `guardrails.json` ask the
user for approval: that is the guard protecting its own setup, not an error.
3. Run `guardrails-check`. The last line must be `ok`; fix every `PROBLEM:` line it prints.
4. Tell the user, briefly:
- The hooks are active from the next prompt.
- To protect critical code (money rules, encoders, deterministic math), use the plugin's lock skill
(`/code-guardrails:lock`).
- The role agents (`code-guardrails:card-auditor`, `test-writer`, `implementer`, `reviewer`) are
available; their write boundaries come from `roles` in `guardrails.json`.
If `guardrails-init` is not found, the plugin's `bin/` folder isn't on PATH in this session: ask the user
to restart Claude Code after installing the plugin.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · alizici/claude-code-guardrails | 86 | MIT |
| CodaColaLight/nightmill | 100 | Apache-2.0 |
| userKael/rastro | 100 | MIT |
| elalfner/relevo | 100 | MIT |
| abatyuk/okf | 100 | MIT |
| duronext/jig | 100 | MIT |
| sh5623/e2e-rail | 100 | MIT |
| Calvin-LLC/skills | 100 | MIT |
| arxdsilva/ai-loops | 100 | MIT |
Database snapshot: 13.11.2026 · package version 15da1c51c853 (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
- 96check
Check that code-guardrails is set up correctly in the current project and explain what it would do. Validates guardrails.json, runs the deletion guard's self-test, lists the code shield's locks, and answers "would the guard allow writing this file / running this command?". Use… - 95devcontainer-init
Use when scaffolding a .devcontainer/ for Shield. Triggers on /shield init-devcontainer, "set up devcontainer", "isolate /implement". # No outputs declared: writes .devcontainer/ files and updates .shield.json # at the repo root — outside the shield output_dir registry scope. - 100git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code. - 90midnight-cq:quality-init
This skill should be used when the user asks to set up linting, add code quality tooling, configure biome, init project quality, initialize code quality, add CI workflows, add GitHub Actions, set up git hooks, add pre-commit hooks, add testing, add Vitest, add Playwright, or… - 90shield-wall
Suki's shield wall for a linear stack. Each warrior's shield overlaps the one below it, and one voice orders the line. Use for autopilot-stack, "stack them, don't ship", "build the stack, I'll land it", or a queue of coupled or sequenced changes built and verified with full… - 95project-init
Use this skill when the user says 'create project structure', 'scaffold project', 'initialize project', 'set up folder structure', 'new project from scratch', or when a new project needs folders and config files created. This skill scaffolds the full project tree based on…