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
The skill provides writing guidelines for different types of documentation and repository artifacts. It includes a script that acts as a hook to automatically present the relevant writing rules to the agent when it uses file-editing tools. The implementation is self-contained, uses no external dependencies, and shows no signs of malicious intent or security vulnerabilities.
- 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 setup-repo's commit gate
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.
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>