Agent skill

Writing Guidelines

by rohitg00 in rohitg00/pro-workflow

Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes.

No licenceAuto-check passedDevelopment

Install Writing Guidelines

skills CLI
$ npx skills add rohitg00/pro-workflow --skill writing-guidelines -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rohitg00/pro-workflow writing-guidelines --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rohitg00/pro-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/writing-guidelines .claude/skills/writing-guidelines && rm -rf skills-src

Use ~/.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/

Facts

Skill name
writing-guidelines
GitHub stars
2.9k
Token cost
~593 tokens
SKILL.md length
305 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
None found

At a glance

Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes.

  • Editing documentation
  • SKILL.md covers Rules, Error messages and UI copy, AI-slop tells to strip and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Any text a human will read

What it does

Writing Guidelines is an agent skill from rohitg00/pro-workflow. Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes. Use when writing or editing documentation, interface copy, or any text a human will read. Says "write the README", "improve this copy", "draft the docs", "word this error".

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Brand voice and tone, Technical documentation and Plain language and style rules. The repository describes itself as: Claude Code learns from your corrections: self-correcting memory that compounds over 50+ sessions. Context engineering, parallel worktrees, agent teams, and 17 battle-tested…

When your agent uses it

  • Editing documentation
  • Any text a human will read

Example prompts

  • “write the README”
  • “improve this copy”
  • “draft the docs”
  • “/writing-guidelines”

What it can do on your machine

Read from SKILL.md and the folder at commit 86d5f27. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Writing Guidelines loads about 593 tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 305 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~593

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 305 words (~593 tokens).

“Write for a reader who is busy and did not see your work. Readability beats cleverness; clarity beats completeness.”

— opening of SKILL.md by rohitg00
name
writing-guidelines

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/writing-guidelines of rohitg00/pro-workflow.

Open the folder on GitHubat commit 86d5f27

Compare with similar skills

Writing Guidelines 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.

Writing Guidelines compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Guidelines this skillrohitg00/pro-workflow2.9k—~593Automated safety check: PassNone
Agent Stylepchalasani/claude-code-tools2k—~1.4kAutomated safety check: PassMIT
Simple Englishropensci/ckanr1043 repos~2kAutomated safety check: PassMIT
Adk Style GuideBrainDAO/adk-ts119—~1.8kAutomated safety check: PassMIT
Documentation Patternsyonatangross/orchestkit290—~830Automated safety check: PassMIT
Technical Writingcitypaul/.dotfiles740—~2.5kAutomated safety check: PassMIT

Similar skills

  • Agent Style

    pchalasani/claude-code-tools

    Literature-backed English technical-prose writing rules (agent-style, 21 rules).

    2k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Simple English

    ropensci/ckanr

    Write or rewrite text in plain, layman-readable English in the spirit of ASD-STE100 Simplified Technical English: short sentences, active voice, simple tenses, one word one meaning, condition before…

    104 GitHub starsUsed in 3 repos~2k tokens
    DevelopmentAuto-check passed
  • Adk Style Guide

    BrainDAO/adk-ts

    ADK-TS brand voice, terminology, and writing conventions. An agent skill from BrainDAO/adk-ts.

    119 GitHub stars~1.8k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Documentation Patterns

    yonatangross/orchestkit

    Technical documentation patterns for READMEs, ADRs, API docs (OpenAPI 3.1), changelogs, and writing style guides.

    290 GitHub stars~830 tokensUpdated today
    DevelopmentAuto-check passed
  • Technical Writing

    citypaul/.dotfiles

    Writing developer-facing prose that can be skimmed first and trusted enough to finish — READMEs, guides, tutorials, reference docs, proposals, PR descriptions, release notes.

    740 GitHub stars~2.5k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Rules for writing PR descriptions, changelog entries and feature documentation in the Opik repository, including the exact headings that CI requires.

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed

More from rohitg00/pro-workflow

All 41 skills in this repo
  • Wiki Builder

    rohitg00/pro-workflow

    Start, structure, and grow a persistent research wiki indexed in pro-workflow's SQLite knowledge base.

    2.9k GitHub stars~1k tokensUpdated 10 days ago
    Auto-check passed
  • LLM Council

    rohitg00/pro-workflow

    Provider-agnostic multi-LLM deliberation. An agent skill from rohitg00/pro-workflow.

    2.9k GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed
  • Survey Generator

    rohitg00/pro-workflow

    Compile a structured literature survey on any AI/ML topic. An agent skill from rohitg00/pro-workflow.

    2.9k GitHub stars~1.6k tokensUpdated 10 days ago
    Auto-check passed
  • Wiki Query

    rohitg00/pro-workflow

    Query pro-workflow wikis via SQLite FTS5 BM25 retrieval. An agent skill from rohitg00/pro-workflow.

    2.9k GitHub stars~554 tokensUpdated 10 days ago
    Auto-check passed
  • Wiki Research Loop

    rohitg00/pro-workflow

    Auto-grow a pro-workflow wiki by running a budget-capped BFS research loop over pluggable source fetchers (web, arXiv, GitHub).

    2.9k GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed
  • Wiki Viewer

    rohitg00/pro-workflow

    Render a self-contained HTML viewer for a pro-workflow wiki.

    2.9k GitHub stars~1.1k tokensUpdated 10 days ago
    Auto-check passed

Questions about Writing Guidelines

What does Writing Guidelines do?

Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes. Writing Guidelines is an agent skill from rohitg00/pro-workflow. Apply clear-writing standards to any prose the agent produces - READMEs, docs, UI copy, error messages, commit and PR text, release notes.

When should I use Writing Guidelines?

Writing Guidelines fits situations like: editing documentation; any text a human will read.

How do I install Writing Guidelines in Claude Code?

Run `npx skills add rohitg00/pro-workflow --skill writing-guidelines -a claude-code`. Or copy the skill folder (skills/writing-guidelines in rohitg00/pro-workflow) into .claude/skills/writing-guidelines in your project. Claude Code loads it when a task matches its description.

How do I install Writing Guidelines in Codex?

Run `npx skills add rohitg00/pro-workflow --skill writing-guidelines -a codex`. Or copy the skill folder (skills/writing-guidelines in rohitg00/pro-workflow) into .agents/skills/writing-guidelines in your project. Codex loads it when a task matches its description.

Can I use Writing Guidelines 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 rohitg00/pro-workflow --skill writing-guidelines -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-guidelines, .gemini/skills/writing-guidelines, .github/skills/writing-guidelines and .opencode/skills/writing-guidelines in your project.

What does Writing Guidelines need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Guidelines is instructions for the agent only.

Does Writing Guidelines 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 Writing Guidelines 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 Writing Guidelines use?

No licence was found for Writing Guidelines or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Writing Guidelines use?

About 593 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Writing Guidelines?

Skills that share tags, products or a category with Writing Guidelines: Agent Style (pchalasani/claude-code-tools, 2k stars), Simple English (ropensci/ckanr, 104 stars), Adk Style Guide (BrainDAO/adk-ts, 119 stars) and Documentation Patterns (yonatangross/orchestkit, 290 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Guidelines?

rohitg00 (a GitHub user) maintains it in rohitg00/pro-workflow, which has 2,907 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on September 29, 2026.

Source: rohitg00/pro-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.