~ / rigs / NickolasBenakis / agent-playbook

NickolasBenakis/agent-playbook

A small playbook for coding agents (Claude Code plugin, Codex, bb): 9 rules, 6 workflow skills, a reviewer and guard hooks, tested head-to-head against the plain model.

↗ GitHub ★ 5 MIT updated 6d ago project Claude CodeCodex Claude plugin
field: unknown workflow: PR / code reviewPlanning & specsSecurity review runs claude in CI
stack: Python
share on X
ARCHETYPE
Pragmatist
A balanced, no-drama setup: some rules, some tools, nothing extreme.
CONTEXT TAX · EVERY TURN
~1.4k tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
0/5
No committed guardrails · details
Quality 5/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit NickolasBenakis/agent-playbook/agents ./rig-agent-playbook/agents
$ npx degit NickolasBenakis/agent-playbook/skills ./rig-agent-playbook/skills
$ npx degit NickolasBenakis/agent-playbook/hooks ./rig-agent-playbook/hooks

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ npx degit NickolasBenakis/agent-playbook/skills/audit .claude/skills/audit
$ npx degit NickolasBenakis/agent-playbook/skills/delegate .claude/skills/delegate
$ npx degit NickolasBenakis/agent-playbook/skills/factory .claude/skills/factory
$ npx degit NickolasBenakis/agent-playbook/skills/fanout .claude/skills/fanout
$ npx degit NickolasBenakis/agent-playbook/skills/oneshot .claude/skills/oneshot
$ npx degit NickolasBenakis/agent-playbook/skills/pr-screenshots .claude/skills/pr-screenshots
$ npx degit NickolasBenakis/agent-playbook/skills/triage .claude/skills/triage
$ curl -fsSL --create-dirs -o .claude/agents/playbook-reviewer.md https://raw.githubusercontent.com/NickolasBenakis/agent-playbook/main/agents/playbook-reviewer.md

This rig commits no guardrails. Here is the community baseline instead — the deny/ask rules most often found across all 16.2k rigs:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(**/.env)",
      "Read(~/.ssh/**)",
      "Bash(git push --force:*)",
      "Read(**/*.pem)",
      "Read(.env)",
      "Read(~/.aws/**)",
      "Read(**/*.key)",
      "Read(**/.env.*)",
      "Bash(git push --force*)",
      "Bash(rm -rf:*)",
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(sudo:*)",
      "Bash(rm -rf /)",
      "Bash(git push -f:*)",
      "Read(.env.*)",
      "Bash(git reset --hard*)",
      "Bash(rm -rf /*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(git push *)",
      "Bash(gh pr merge *)",
      "Bash(git commit:*)",
      "Bash(rm *)",
      "Bash(gh pr merge:*)",
      "Bash(gh pr create *)",
      "Bash(git reset --hard:*)",
      "Bash(npm publish:*)",
      "Bash(git rebase *)"
    ]
  }
}

Skills (7)

Subagents (1)

playbook-reviewerIndependent, read-only reviewer for a finished change. Give it the acceptance criteria (or plan) and the path to a diff file; it reports security holes, correctness bugs and spec gaps, not style. Use

Similar rigs

copied ✓