Agent skill

Pi Runbook Writer

by Pr1p in Pr1p/pi-runbook

A skill your agent uses when creating, editing, or polishing pi-runbook content: README/index pages, docs, journal notes, experiments, bilingual documentation, source-reading summaries…

No licenceAuto-check passedDevOps & Cloud

Install Pi Runbook Writer

skills CLI
$ npx skills add Pr1p/pi-runbook --skill pi-runbook-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Pr1p/pi-runbook pi-runbook-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Pr1p/pi-runbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pi-runbook-writer .claude/skills/pi-runbook-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pi-runbook-writer
GitHub stars
143
Token cost
~796 tokens
SKILL.md length
372 words
Files
2
Skills in repo
2
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when creating, editing, or polishing pi-runbook content: README/index pages, docs, journal notes, experiments, bilingual documentation, source-reading summaries…

  • Works in 5 steps: One-line project positioning. → A short “why this exists” paragraph. → “How to read” path. → …
  • Polishing pi-runbook content: README/index pages
  • SKILL.md covers Core posture, Page types, Bilingual policy and Public hygiene checklist, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Pi Runbook Writer is an agent skill from Pr1p/pi-runbook. Use when creating, editing, or polishing pi-runbook content: README/index pages, docs, journal notes, experiments, bilingual documentation, source-reading summaries, public-facing wording, and removing local/private implementation traces. Enforce a source-grounded field-guide/reference style inspired by concise text-first knowledge repositories.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in DevOps & Cloud, covering Runbooks and postmortems, Translation and Source-grounded notebooks. The repository describes itself as: Source-reading field guide for Pi Agent Harness: architecture notes, design breakdowns, and experiments.

When your agent uses it

  • Polishing pi-runbook content: README/index pages
  • Bilingual documentation
  • Source-reading summaries
  • Public-facing wording

Example prompts

  • “/pi-runbook-writer”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. One-line project positioning.
  2. A short “why this exists” paragraph.
  3. “How to read” path.
  4. Reference sections grouped by topic.
  5. Repo layout and writing principles if helpful.

What it can do on your machine

Read from SKILL.md and the folder at commit c2e404f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pi Runbook Writer loads about 796 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 372 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~796

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 372 words (~796 tokens).

“Use this skill to keep pi-runbook readable as a public source-reading field guide, not an internal work log.”

— opening of SKILL.md by Pr1p
name
pi-runbook-writer

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/pi-runbook-writer of Pr1p/pi-runbook.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit c2e404f

Compare with similar skills

Pi Runbook Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pi Runbook Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pi Runbook Writer this skillPr1p/pi-runbook143—~796Automated safety check: PassNone
Obsidian WriterAtmosphere/atmosphere3.8k—~2.6kAutomated safety check: PassApache-2.0
Om QA Buddyopen-mercato/skills231—~1.9kAutomated safety check: NotesMIT
NotionOpenHands/extensions163—~945Automated safety check: PassMIT
Brainjeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: PassApache-2.0
Architecturenteract/nteract180—~497Automated safety check: PassBSD-3-Clause

Similar skills

  • Obsidian Writer

    Atmosphere/atmosphere

    Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.

    3.8k GitHub stars~2.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Om QA Buddy

    open-mercato/skills

    Runs a manual QA session for a PR, issue, or branch — publishes an interactive runbook the tester works through in parallel from the moment a plan exists, updated with AI verdicts and bugs at the end.

    231 GitHub stars~1.9k tokensUpdated 5 days ago
    DevOps & CloudAuto-check: notes
  • Notion

    OpenHands/extensions

    Create, search, and update Notion pages/databases using the Notion API.

    163 GitHub stars~945 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Brain

    jeremylongshore/tons-of-skills-marketplace

    Answers questions about your own systems, notes, decisions, runbooks, and conventions from your governed knowledge brain, returning a qmd:// citation for every claim — receipts, not recall.

    2.8k GitHub stars~1.9k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Architecture

    nteract/nteract

    Architecture and documentation framing for cross-cutting repo decisions, docs taxonomy placement, ADRs, memos, PRDs, implementation plans, audits, measurements, runbooks, and source-grounded…

    180 GitHub stars~497 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Documentation Standards

    softspark/ai-toolkit

    KB conventions: YAML frontmatter, 10-category taxonomy (reference/howto/procedures/troubleshooting/best-practices/decisions/runbooks/planning/business/templates).

    179 GitHub stars~1.8k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed

More from Pr1p/pi-runbook

  • Pi Visual Map Maker

    Pr1p/pi-runbook

    Create and maintain consistent hand-drawn architecture visuals for pi-runbook.

    143 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Pi Runbook Writer

What does Pi Runbook Writer do?

A skill your agent uses when creating, editing, or polishing pi-runbook content: README/index pages, docs, journal notes, experiments, bilingual documentation, source-reading summaries…. Pi Runbook Writer is an agent skill from Pr1p/pi-runbook. Use when creating, editing, or polishing pi-runbook content: README/index pages, docs, journal notes, experiments, bilingual documentation, source-reading summaries, public-facing wording, and removing local/private implementation traces.

When should I use Pi Runbook Writer?

Pi Runbook Writer fits situations like: polishing pi-runbook content: README/index pages; bilingual documentation; source-reading summaries; public-facing wording.

How do I install Pi Runbook Writer in Claude Code?

Run `npx skills add Pr1p/pi-runbook --skill pi-runbook-writer -a claude-code`. Or copy the skill folder (.agents/skills/pi-runbook-writer in Pr1p/pi-runbook) into .claude/skills/pi-runbook-writer in your project. Claude Code loads it when a task matches its description.

How do I install Pi Runbook Writer in Codex?

Run `npx skills add Pr1p/pi-runbook --skill pi-runbook-writer -a codex`. Or copy the skill folder (.agents/skills/pi-runbook-writer in Pr1p/pi-runbook) into .agents/skills/pi-runbook-writer in your project. Codex loads it when a task matches its description.

Can I use Pi Runbook Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Pr1p/pi-runbook --skill pi-runbook-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pi-runbook-writer, .gemini/skills/pi-runbook-writer, .github/skills/pi-runbook-writer and .opencode/skills/pi-runbook-writer in your project.

What does Pi Runbook Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Pi Runbook Writer is instructions for the agent only.

Does Pi Runbook Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Pi Runbook Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pi Runbook Writer use?

No licence was found for Pi Runbook Writer or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Pi Runbook Writer use?

About 796 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pi Runbook Writer?

Skills that share tags, products or a category with Pi Runbook Writer: Obsidian Writer (Atmosphere/atmosphere, 3.8k stars), Om QA Buddy (open-mercato/skills, 231 stars), Notion (OpenHands/extensions, 163 stars) and Brain (jeremylongshore/tons-of-skills-marketplace, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pi Runbook Writer?

Pr1p (a GitHub user) maintains it in Pr1p/pi-runbook, which has 143 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 20, 2026.

Source: Pr1p/pi-runbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.