Skip to content
Skills Library
Programming · Building & coding

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.

Licence
MIT
Last repository change
07.11.2026

Assessment and security

86/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content21 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.

Licence

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

RepositoryScoreLicence
This page · alizici/claude-code-guardrails86MIT
CodaColaLight/nightmill100Apache-2.0
userKael/rastro100MIT
elalfner/relevo100MIT
abatyuk/okf100MIT
duronext/jig100MIT
sh5623/e2e-rail100MIT
Calvin-LLC/skills100MIT
arxdsilva/ai-loops100MIT

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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.