src/ai/skills/technical-writing/SKILL.md
Enforces ventilated prose and concise technical writing standards when the user is writing or editing standalone documentation files (e.g., Markdown, AsciiDoc). This skill should not be used for code documentation or docstrings.
npx skillsauth add mkobit/dotfiles technical-writingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Follow these rules when writing standalone documentation.
Write one sentence per line. Break lines at every period that ends a sentence. This improves diff readability. This makes sentence length obvious.
Use sentence case for all headers. Capitalize only the first word and proper nouns.
Be terse. Omit needless words. Use active voice. Focus on self-documenting structure.
Do not wrap paragraphs. Output text strictly following these rules.
documentation
Enforces minimal context in agent configuration files like AGENTS.md, CLAUDE.md, GEMINI.md, and *.mdc to improve task success rates and reduce inference costs. Use when writing or modifying agent context files.
development
Enforces functional programming, immutability, and strict type safety when writing, reviewing, or editing TypeScript and React code.
tools
Provides guidelines and workflows for programmatically reviewing pull requests and creating pending reviews with inline comments using the GitHub CLI and REST API. Use this when instructed to review a PR or when providing feedback.
development
A simple example skill demonstrating the format.