Scaffolds principle-anchoring configuration for a project. Writes docs/agents/principles.md, adds a `### Principles` block to `## Agent skills` in CLAUDE.md or AGENTS.md, and optionally drafts hook integration snippets for settings.json or tool-routing. Run once per project before using stay-principled:grill. Re-run only if the principles file layout changes.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Setup Principles
Scaffold the per-project configuration that `stay-principled:grill` reads. This is a prompt-driven skill, not a deterministic script. Explore, present what you found, confirm with the user, then write.
## Process
### 1. Explore
Look at the current repo to understand its starting state. Read whatever exists; don't assume:
- `docs/principles.md`, `docs/ops-principles.md`, any sibling `*principles*.md` files at the repo root or under `docs/`
- `docs/agents/principles.md`: existing config; update in place if found
- `CLAUDE.md` (preferred) or `AGENTS.md` at the repo root: does either exist? Is there already an `## Agent skills` section?
- `claude plugin list --json`: is `tool-routing` installed and enabled? (Affects whether Pattern C is offered.)
- `git rev-parse --show-toplevel`: used as the canonical repo root for path resolution; principles inside worktrees still live at the worktree root.
### 2. Present findings and ask
Summarize what's present and what's missing. Then walk the user through the four sections **one at a time**. Present a section, get the user's answer, then move to the next. Don't dump all sections at once.
…
The line at the top of this page pins the label git:20260911.167fad7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_kffrxmp45ba4jxfw
GET https://markdownregistry.com/api/v1/resolve?ref=technicalpickles/pickled-claude-plugins/setup
GET https://markdownregistry.com/api/v1/blob/ce9b85f9d2877b50c87447477a7106bc82e753450051ed0acfb7343d0c0825d9
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
technicalpickles/pickled-claude-plugins · plugins/actually-lsp/skills/actually-lsp-doctor/SKILL.md · Diagnose and fix LSP setup for the current project's detected ecosystems (Rust, TypeScript, Ruby). Use when the…
technicalpickles/pickled-claude-plugins · plugins/actually-lsp/skills/actually-lsp-ignore/SKILL.md · Ignore actually-lsp nudges for an ecosystem in this project. Use when the user wants to silence, dismiss, or ignore the…
technicalpickles/pickled-claude-plugins · plugins/agent-meta/skills/harness-binary-spelunking/SKILL.md · Use when investigating an agent-harness CLI's internals (Claude Code, codex, opencode, or similar): extracting the…
technicalpickles/pickled-claude-plugins · plugins/automic-vault/skills/automic-vault-credentials/SKILL.md · Use when a command mentions `av`, Automic Vault or automic-vault, when a task needs a credential (GitHub token, API…
technicalpickles/pickled-claude-plugins · plugins/buildkite/skills/developing-pipelines/SKILL.md · Use when creating, modifying, or debugging Buildkite pipeline YAML files - ensures current syntax from official docs…
technicalpickles/pickled-claude-plugins · plugins/buildkite/skills/investigating-builds/SKILL.md · Use when the user is working with an existing Buildkite CI run and wants to understand, diagnose, or act on it. Strong…
technicalpickles/pickled-claude-plugins · plugins/ci-cd-tools/skills/fixing-ci/SKILL.md · Use when CI is failing on a branch, PR, or specific Buildkite build and the user wants to iteratively fix it through…
technicalpickles/pickled-claude-plugins · plugins/come-on/skills/come-on/SKILL.md · Use when a reply will hand the user a result they'll act on or repeat to others. You MUST load this at the start of the…
garrytan/gbrain · plugin/skills/setup/SKILL.md · Add keyless GBrain memory to an existing agent, or connect a hosted brain while preserving identity and configuration
garrytan/gbrain · skills/setup/SKILL.md · Add keyless GBrain memory to an existing agent, or connect a hosted brain while preserving identity and configuration
nanocoai/nanoclaw · .claude/skills/setup/SKILL.md · Run initial NanoClaw setup. Use when user wants to install NanoClaw, configure it, or go through first-time setup…
tencent/teamai-cli · skill-data/setup/SKILL.md · TeamAI day 0 and repo lifecycle: create a team repo as admin, join an existing team as a member, manage members, roles…
fcakyon/claude-codex-settings · plugins/overleaf-skills/skills/setup/SKILL.md · This skill should be used when user asks to "set up overleaf", "configure overleaf cookie", "overleaf auth failed"…
fcakyon/claude-codex-settings · plugins/github-dev/skills/setup/SKILL.md · This skill should be used when the user asks "how to setup GitHub CLI", "configure gh", "gh auth not working", "GitHub…
fcakyon/claude-codex-settings · plugins/paper-search-tools/skills/setup/SKILL.md · This skill should be used when the user asks to "set up paper search", reports "paper-search command not found", wants…
