Natural Writing
a2ui-project/a2ui
Contains well-defined rules for creating natural, accurate, and readable writing.
Write, update, or review Serial Studio's user-facing documentation: the doc/help manual, README.md, and examples READMEs.
Install Ss Docs
$ npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Serial-Studio/Serial-Studio ss-docs --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Serial-Studio/Serial-Studio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ss-docs .claude/skills/ss-docs && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "ss-docs" agent skill from https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docs into .claude/skills/ss-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ss-docs", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Serial-Studio/Serial-Studio ss-docs --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Serial-Studio/Serial-Studio.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/ss-docs .agents/skills/ss-docs && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "ss-docs" agent skill from https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docs into .agents/skills/ss-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ss-docs", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Serial-Studio/Serial-Studio ss-docs --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Serial-Studio/Serial-Studio.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/ss-docs .cursor/skills/ss-docs && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "ss-docs" agent skill from https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docs into .cursor/skills/ss-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ss-docs", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Serial-Studio/Serial-Studio.git --path .claude/skills/ss-docs--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Serial-Studio/Serial-Studio ss-docs --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Serial-Studio/Serial-Studio.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/ss-docs .gemini/skills/ss-docs && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "ss-docs" agent skill from https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docs into .gemini/skills/ss-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ss-docs", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Serial-Studio/Serial-Studio ss-docsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Serial-Studio/Serial-Studio.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/ss-docs .github/skills/ss-docs && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "ss-docs" agent skill from https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docs into .github/skills/ss-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ss-docs", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Serial-Studio/Serial-Studio ss-docs --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Serial-Studio/Serial-Studio.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/ss-docs .opencode/skills/ss-docs && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "ss-docs" agent skill from https://github.com/Serial-Studio/Serial-Studio/tree/master/.claude/skills/ss-docs into .opencode/skills/ss-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ss-docs", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
ss-docs- GitHub stars
- 7.2k
- Token cost
- ~1.6k tokens
- SKILL.md length
- 751 words
- Files
- 5 (incl. references)
- Skills in repo
- 15
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Write, update, or review Serial Studio's user-facing documentation: the doc/help manual, README.md, and examples READMEs.
- Works in 5 steps: The code is the ground truth. Every… → Manual voice, not blog voice.… → Linter-clean is necessary, not… → …
- Asked to update the documentation
- SKILL.md covers Invariants — name the ones…, Update workflow, Review workflow (read-only) and New-entry checklist, plus 1 more section
- Calls python
What it does
Ss Docs is an agent skill from Serial-Studio/Serial-Studio. Write, update, or review Serial Studio's user-facing documentation: the doc/help manual, README.md, and examples READMEs. Use when asked to "update the documentation", "update the docs", "write a help entry", "review the documentation", "edit doc/help", "document <feature", or when touching any Markdown under doc/help/. Grounds every factual claim in code, mirrors the manual's voice and structure, registers new pages in help.json, and runs a two-tier AI-writing-tell check (documentation-verify.py first…
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/eeat-manual.md`, `references/ground-truth-factcheck.md` and `references/manual-heuristics.md`).
It sits in Development, covering Technical documentation and Humanizing AI text. The repository describes itself as: Open-source telemetry dashboard. Supports UART, BLE, MQTT, Modbus, CAN Bus and more.
When your agent uses it
- Asked to update the documentation
- Update the docs
- Write a help entry
- Review the documentation
Example prompts
- “update the documentation”
- “update the docs”
- “write a help entry”
- “/ss-docs”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- The code is the ground truth. Every default value, range, UI label, menu path, Pro
- Manual voice, not blog voice. Declarative present tense, no tutorial "we/let's", no
- Linter-clean is necessary, not sufficient. After the linter passes, run the structural
- Structure mirrors the neighbors. Read 1-2 sibling entries from the same help.json
- New pages register in doc/help/help.json (id, title, section, file) and
What it can do on your machine
Read from SKILL.md and the folder at commit 34c87a4. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Ss Docs loads about 1.6k tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 139 tokens; SKILL.md has 751 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 751 words (~1,591 tokens).
“The manual competes with the code for the user's trust; a wrong default or a blog-voiced paragraph loses it. This skill covers doc/help/, README.md, and examples//README.md. The AI-facing material (CLAUDE.md, doc/claude/**, the skills) belongs to ss-ai-audit — don't restyle it…”
- name
- ss-docs
- argument-hint
- [update <file> | review <file|dir> | new <topic>]
Files
SKILL.md and 4 other files (references) in .claude/skills/ss-docs of Serial-Studio/Serial-Studio.
- SKILL.md
- references/eeat-manual.md
- references/ground-truth-factcheck.md
- references/manual-heuristics.md
- references/second-order-tells.md
Open the folder on GitHubat commit 34c87a4
Compare with similar skills
Ss Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Ss Docs this skillSerial-Studio/Serial-Studio | 7.2k | — | ~1.6k | Automated safety check: Pass | Custom licence | |
| Natural Writinga2ui-project/a2ui | 17k | 1 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| No TropesOutThisLife/brooklyn-skills | 198 | — | ~455 | Automated safety check: Pass | MIT | |
| Human Writingkataras/jwt | 212 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Writewaynesutton/markdown-site | 628 | — | ~3k | Automated safety check: Pass | MIT | |
| Writerrileyhilliard/claude-essentials | 130 | — | ~2k | Automated safety check: Pass | MIT |
Similar skills
No Tropes
OutThisLife/brooklyn-skills
Detect and eliminate common AI writing tropes from generated text.
Human Writing
kataras/jwt
A skill your agent uses when writing or editing any prose in this repository - the book's preface, its chapters and epilogue, the brand kit notes, the agent skill documents, the changelog, and the…
Write
waynesutton/markdown-site
Writing style guide for technical content, social media, blog posts, READMEs, git commits, and developer documentation.
Writer
rileyhilliard/claude-essentials
Writing style and tone guide for human-sounding content. An agent skill from rileyhilliard/claude-essentials.
Moonbit Docs Maintainer
moonbitlang/moonbit-docs
A skill your agent uses when maintaining the moonbitlang/moonbit-docs repository, including Sphinx docs under next/, MoonBit examples under next/sources/, error-code documentation, gettext…
More from Serial-Studio/Serial-Studio
All 15 skills in this repoQt Cpp Review
Serial-Studio/Serial-Studio
Qt6/C++ deep code review for Serial Studio. An agent skill from Serial-Studio/Serial-Studio.
Qt Qml Review
Serial-Studio/Serial-Studio
Qt6/QML deep code review for Serial Studio. An agent skill from Serial-Studio/Serial-Studio.
Ss Spec
Serial-Studio/Serial-Studio
Phase 1 of Serial Studio's spec-driven workflow: capture WHAT a feature must do and WHY, with no implementation detail.
Cpp Compiler Flags
Serial-Studio/Serial-Studio
C++ compiler/linker flag guidance for Serial Studio's build (GCC, Clang, AppleClang, MSVC cl.exe, clang-cl, MinGW, IntelLLVM).
Ss Cpp Modern
Serial-Studio/Serial-Studio
Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.
Qt Qml
Serial-Studio/Serial-Studio
QML authoring best practices for Serial Studio (Qt 6.11). An agent skill from Serial-Studio/Serial-Studio.
Related
Categories
Questions about Ss Docs
What does Ss Docs do?
Write, update, or review Serial Studio's user-facing documentation: the doc/help manual, README.md, and examples READMEs. Ss Docs is an agent skill from Serial-Studio/Serial-Studio.md, and examples READMEs.
When should I use Ss Docs?
Ss Docs fits situations like: asked to update the documentation; update the docs; write a help entry; review the documentation.
How do I install Ss Docs in Claude Code?
Run `npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a claude-code`. Or copy the skill folder (.claude/skills/ss-docs in Serial-Studio/Serial-Studio) into .claude/skills/ss-docs in your project. Claude Code loads it when a task matches its description.
How do I install Ss Docs in Codex?
Run `npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a codex`. Or copy the skill folder (.claude/skills/ss-docs in Serial-Studio/Serial-Studio) into .agents/skills/ss-docs in your project. Codex loads it when a task matches its description.
Can I use Ss Docs in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Serial-Studio/Serial-Studio --skill ss-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ss-docs, .gemini/skills/ss-docs, .github/skills/ss-docs and .opencode/skills/ss-docs in your project.
What does Ss Docs need to run?
Going by SKILL.md and its folder, Ss Docs needs the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Ss Docs access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Ss Docs safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Ss Docs use?
Ss Docs has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Ss Docs use?
About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.4k tokens, read only when the agent opens those files.
What are the alternatives to Ss Docs?
Skills that share tags, products or a category with Ss Docs: Natural Writing (a2ui-project/a2ui, 17k stars), No Tropes (OutThisLife/brooklyn-skills, 198 stars), Human Writing (kataras/jwt, 212 stars) and Write (waynesutton/markdown-site, 628 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Ss Docs?
Serial-Studio (a GitHub organization) maintains it in Serial-Studio/Serial-Studio, which has 7,224 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 6, 2026.
Source: Serial-Studio/Serial-Studio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.