guideline-writing

Solid

Guideline-authoring craft for instruction SoTs (.claude/ guides, CLAUDE.md, plan files) — operative rules vs recital, MUST/SHOULD/MAY force tiers, pruning, bloat control, blind review protocol, deliberation-narrative ban. Use when writing, editing, or reviewing an agent instruction file, policy, runbook, command SoT, or plan file, or when a guideline change needs a minimal-edit or blind review.

Code & Development 66 stars 10 forks Updated today MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
61
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Guideline Writing Craft for authoring the instruction layer itself — the `.claude/` guide SoTs, `CLAUDE.md`, and plan files. Content pages have the four content-craft skills (jrn·con·enc·cit); this skill is their counterpart for the meta layer. Dotted IDs: `gdl.*` ([criteria.json](criteria.json)); the deterministic detectors live in [checks.py](checks.py) and run inside `python tools/lint.py meta`. ## Operative Rule vs Recital Every sentence in a guideline is one of two kinds, and only the first belongs in the body: - **Operative rule** — tells the reader what to do, when, and how to tell they did it right. Test: delete the sentence; if an executor could now act differently and still believe they complied, the sentence was operative. - **Recital** — explains how the rule came to be: options weighed, benchmarks absorbed, incidents survived, dates adopted. Recitals are history; history's SoT is `log.md` (append-only). A recital in the body is **deliberation narrative** — the central antipattern this skill exists to prevent. A failure mode earns **at most one line in the body** — the concrete trigger the rule guards against, stated as a present-tense condition ("a partial edit bumps only the date and masks body staleness"), never as a war story ("after the 05-20 incident we decided…"). The story goes to `log.md`. ## Force Tiers — MUST / SHOULD / MAY State every rule at exactly one force tier, and make the tier visible in the wording: | Tier | Wording | Reader's obligat...

Details

Author
alfadur7
Repository
alfadur7/llm-wiki-newsroom
Created
1 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Solid

guidance

Authoritative guidance for building Claude Code skills, agents, and plugins, vendored into this repository. Use when you need the rules or best practices for a skill, agent, hook, or plugin — designing, reviewing, hardening, or checking one against the guidance. Does not run an interview to build a new skill or agent from scratch — use skill-builder or agent-builder. Does not write feature code, review application code, or build non-plugin features.

126 Updated 2 days ago
testdouble
Code & Development Listed

rule-audit

Find out which of your agent rules are actually enforced and which are only hope — then convert the ones that matter into deterministic enforcement. Use whenever the user says Claude ignored my rules, it pushed to main again, it keeps forgetting my instructions, my CLAUDE.md isn't working, "same mistake again", "I told it not to", "rule follow nahi karta", "phir wahi ghalti" — or asks to add a hook, block a command, enforce a convention, run something automatically after edits, review their CLAUDE.md, or make an instruction actually stick. Also use before writing a new rule, to decide whether it belongs in prose or in the harness, and when a CLAUDE.md has grown long enough that compliance is degrading. It inventories every rule you have, classifies each as enforceable or advisory, generates the hook or permission config for the enforceable ones, tells you plainly which rules can never be enforced, and prunes the rest so the remaining instructions actually get followed.

0 Updated today
xniperbuilds
Code & Development Solid

writing-guidelines

Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes. Use when writing or editing documentation, interface copy, or any text a human will read. Says "write the README", "improve this copy", "draft the docs", "word this error".

2,651 Updated 6 days ago
rohitg00