tech-doc-writing
Skill19 starsChanged 5 months agoMITView on GitHub
Write technical documentation, guides, blog posts, tutorials, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
In this repository14 other files it gives its agents.
- good-questionSkill
- knowledge-distillation-from-discussionSkill
- mao-semantic-searchSkill
- markdown-to-htmlSkill
- markitdown-convertSkill
- notion-to-markdownSkill
- obsidian-auto-classifierSkill
- obsidian-batch-yamlSkill
- obsidian-semantic-searchSkill
- paper-code-auditSkill
- paper-deep-readerSkill
- paper-finderSkill
- paper-quick-readSkill
- weekly-report-generatorSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. About 0 are common, 19 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈19
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 9
Write long-form content that sounds like a real person or brand, not generic AI output.
- Distinctive: line 22
Prefer short, direct sentences over padded ones.
- Distinctive: line 23
Use specific numbers when available and sourced.
- Distinctive: line 24
Never invent biographical facts, company metrics, or customer evidence.
- Distinctive: line 28
If the user wants a specific voice, collect one or more of:
- Distinctive: line 42
If no voice references are given, default to a direct, operator-style voice: concrete, practical, and low on hype.
- Distinctive: line 46
Delete and rewrite any of these:
- Distinctive: line 57
Start each section with evidence, example, or scene.
- Distinctive: line 59
Remove anything that sounds templated or self-congratulatory.
- Distinctive: line 65
use code or terminal examples in every major section
- Distinctive: line 69
start with tension, contradiction, or a sharp observation
- Distinctive: line 70
keep one argument thread per section
- Distinctive: line 71
use examples that earn the opinion
- Distinctive: line 74
keep the first screen strong
- Distinctive: line 76
use clear section labels and easy skim structure
- Distinctive: line 81
verify factual claims against provided sources
- Distinctive: line 82
remove filler and corporate language
- Distinctive: line 84
ensure every section adds new information
- Distinctive: line 85
check formatting for the intended platform
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Article Writing
Write long-form content that sounds like a real person or brand, not generic AI output.
When to Activate
- drafting blog posts, essays, launch posts, guides, tutorials, or newsletter issues
- turning notes, transcripts, or research into polished articles
- matching an existing founder, operator, or brand voice from examples
- tightening structure, pacing, and evidence in already-written long-form copy
Core Rules
- Lead with the concrete thing: example, output, anecdote, number, screenshot description, or code block.
- Explain after the example, not before.
- Prefer short, direct sentences over padded ones.
- Use specific numbers when available and sourced.
- Never invent biographical facts, company metrics, or customer evidence.
Voice Capture Workflow
If the user wants a specific voice, collect one or more of:
- published articles
- newsletters
- X / LinkedIn posts
- docs or memos
- a short style guide
Then extract:
- sentence length and rhythm
- whether the voice is formal, conversational, or sharp
- favored rhetorical devices such as parentheses, lists, fragments, or questions
- tolerance for humor, opinion, and contrarian framing
- formatting habits such as headers, bullets, code blocks, and pull quotes
If no voice references are given, default to a direct, operator-style voice: concrete, practical, and low on hype.
Banned Patterns
Delete and rewrite any of these:
- generic openings like "In today's rapidly evolving landscape"
- filler transitions such as "Moreover" and "Furthermore"
- hype phrases like "game-changer", "cutting-edge", or "revolutionary"
- vague claims without evidence
- biography or credibility claims not backed by provided context
Writing Process
- Clarify the audience and purpose.
- Build a skeletal outline with one purpose per section.
- Start each section with evidence, example, or scene.
- Expand only where the next sentence earns its place.
- Remove anything that sounds templated or self-congratulatory.
Structure Guidance
Technical Guides
- open with what the reader gets
- use code or terminal examples in every major section
- end with concrete takeaways, not a soft summary
Essays / Opinion Pieces
- start with tension, contradiction, or a sharp observation
- keep one argument thread per section
- use examples that earn the opinion
Newsletters
- keep the first screen strong
- mix insight with updates, not diary filler
- use clear section labels and easy skim structure
Quality Gate
Before delivering:
- verify factual claims against provided sources
- remove filler and corporate language
- confirm the voice matches the supplied examples
- ensure every section adds new information
- check formatting for the intended platform
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

