writing-rules
The writing rules for every repo artifact: docs, code comments, commit messages, PR bodies, issue bodies. Use before writing or reviewing prose anywhere in a repo — README, docs, CLAUDE.md, skill files, commits, PRs, issues.
How do I install this agent skill?
npx skills add https://github.com/timschoch/skilly --skill writing-rulesIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a set of writing and documentation rules for repositories. It includes a hook to automatically provide relevant style guidelines to the agent when writing files and a validation script to ensure Mermaid diagrams are syntactically correct.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Writing rules
One list, one copy, synced from the hub — rules update here, never in a consumer. Enforcement varies per repo; the rules do not.
The rules live in sidecar files, one per style, so only what applies gets injected:
- rules/all.md — every file: audience, words and links, the never list, where a statement lives
- rules/plain.md — a person reads it: README, docs, code comments
- rules/dense.md — only an agent reads it: CLAUDE.md, AGENTS.md, skill files, agent docs; where both could apply, dense wins
- rules/git.md — commits, PRs, issues; the format is enforced by the workflow Bundle's commit-msg hook
Reviewing or writing prose by hand? Read the sidecars above — this file holds no rule.
Injection on write actions
scripts/inject-writing-rules.mjs is a PreToolUse hook: on every file-writing tool call it prints the matching rules (all + plain|dense by path) as additional context, so the writer sees them without loading this skill. /setup-repo wires it into .claude/settings.json. Markdown files only; node_modules, .temp/ and the synced .claude/skills/.claude/rules trees are skipped.
Mermaid check
scripts/check-mermaid.mjs parses every mermaid diagram in the .md, .mdx and .mmd files a branch changes. The verify skill's push stage runs it. It needs the repo's mermaid and jsdom devDependencies; /setup-repo installs them.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/timschoch/skilly/writing-rules">View writing-rules on skillZs</a>