Agent skill

Writing For A Technical Audience

by ed3dai in ed3dai/ed3d-plugins

A skill your agent uses when writing documentation, guides, API references, or technical content for developers - enforces clarity, conciseness, and authenticity while avoiding AI writing patterns…

No licenceAuto-check passedWriting & Content

Install Writing For A Technical Audience

skills CLI
$ npx skills add ed3dai/ed3d-plugins --skill writing-for-a-technical-audience -a claude-code

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

GitHub CLI
$ gh skill install ed3dai/ed3d-plugins writing-for-a-technical-audience --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/ed3dai/ed3d-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ed3d-house-style/skills/writing-for-a-technical-audience .claude/skills/writing-for-a-technical-audience && 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-for-a-technical-audience
GitHub stars
250
Token cost
~3.9k tokens
SKILL.md length
1,763 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when writing documentation, guides, API references, or technical content for developers - enforces clarity, conciseness, and authenticity while avoiding AI writing patterns…

  • Works in 6 steps: Clarity → Conciseness → Consistency → …
  • Writing documentation
  • SKILL.md covers Overview, When to Use, The Three Pillars and Avoid AI Writing Patterns, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing For A Technical Audience is an agent skill from ed3dai/ed3d-plugins. Use when writing documentation, guides, API references, or technical content for developers - enforces clarity, conciseness, and authenticity while avoiding AI writing patterns that signal inauthenticity

Its SKILL.md is about 3.9k 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 Writing & Content, covering Humanizing AI text. The repository describes itself as: Ed's repo of Claude Code plugins, centered around a research-plan-implement workflow. Only a tiny bit cursed. If you're lucky.

When your agent uses it

  • Writing documentation
  • Technical content for developers - enforces clarity
  • Authenticity while avoiding AI writing patterns that signal inauthenticity

Example prompts

  • “/writing-for-a-technical-audience”

Requirements

  • Python 3
  • Node.js
  • A credential in YOUR_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Clarity
  2. Conciseness
  3. Consistency
  4. Assumes Too Much
  5. Perfect World Examples
  6. Vague and Unhelpful

What it can do on your machine

Read from SKILL.md and the folder at commit 0c90f4b. 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 (its code samples are python, markdown, javascript and typescript).

    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 For A Technical Audience loads about 3.9k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 1,763 words of instructions outside code blocks.

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

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 1,763 words (~3,862 tokens).

“Core principle: Technical writing must be clear, concise, and authentic. Clarity and technical depth are not opposites - you can have both. Avoid AI writing patterns that make content feel robotic or inauthentic.  Why this matters: Developers value their…”

— opening of SKILL.md by ed3dai
name
writing-for-a-technical-audience
user-invocable
false

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/ed3d-house-style/skills/writing-for-a-technical-audience of ed3dai/ed3d-plugins.

Open the folder on GitHubat commit 0c90f4b

Compare with similar skills

Writing For A Technical Audience 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 For A Technical Audience compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing For A Technical Audience this skilled3dai/ed3d-plugins250—~3.9kAutomated safety check: PassNone
HumanizerAzure-Samples/interview-coach-agent-framework17338 repos~5.8kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover24k—~3.5kAutomated safety check: PassMIT
Install Anti Sloptrycompai/crm11k1 repos~881Automated safety check: PassMIT
Stop SlopXe/site7328 repos~423Automated safety check: PassMIT

Similar skills

  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    173 GitHub starsUsed in 38 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    24k GitHub stars~3.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Install Anti Slop

    trycompai/crm

    Install and configure the anti-slop Oxlint plugin in a local TypeScript or JavaScript repository.

    11k GitHub starsUsed in 1 repo~881 tokens
    Writing & ContentAuto-check passed
  • Stop Slop

    Xe/site

    Remove AI writing patterns from prose. An agent skill from Xe/site.

    732 GitHub starsUsed in 8 repos~423 tokens
    Writing & ContentAuto-check passed
  • Chinese Text Humanizer

    op7418/Humanizer-zh

    Edits Chinese articles, comments and documents to remove filler, repetition and template phrasing while keeping the facts, the level of certainty and the author's voice.

    19k GitHub stars~2k tokensUpdated 18 days ago
    Writing & ContentAuto-check passed

More from ed3dai/ed3d-plugins

All 34 skills in this repo
  • Systematic Debugging

    ed3dai/ed3d-plugins

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior, before proposing fixes - four-phase framework (root cause investigation, pattern analysis, hypothesis…

    250 GitHub starsUsed in 3 repos~2.4k tokens
    Auto-check passed
  • A skill your agent uses when creating or editing skills, before deployment, to verify they work under pressure and resist rationalization - applies RED-GREEN-REFACTOR cycle to process documentation…

    250 GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check passed
  • Brainstorming

    ed3dai/ed3d-plugins

    A skill your agent uses when creating or developing anything, before writing code or implementation plans - refines rough ideas into fully-formed designs through structured Socratic questioning…

    250 GitHub starsUsed in 1 repo~4.3k tokens
    Auto-check passed
  • Writing Good Tests

    ed3dai/ed3d-plugins

    A skill your agent uses when writing or reviewing tests - covers test philosophy, condition-based waiting, mocking strategy, and test isolation

    250 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Writing Skills

    ed3dai/ed3d-plugins

    A skill your agent uses when creating new skills, editing existing skills, or verifying skills work before deployment - applies TDD to process documentation by testing with subagents before writing…

    250 GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Coding Effectively

    ed3dai/ed3d-plugins

    ALWAYS use this skill when writing or refactoring code. An agent skill from ed3dai/ed3d-plugins.

    250 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Writing For A Technical Audience

What does Writing For A Technical Audience do?

A skill your agent uses when writing documentation, guides, API references, or technical content for developers - enforces clarity, conciseness, and authenticity while avoiding AI writing patterns…. Writing For A Technical Audience is an agent skill from ed3dai/ed3d-plugins.

When should I use Writing For A Technical Audience?

Writing For A Technical Audience fits situations like: writing documentation; technical content for developers - enforces clarity; authenticity while avoiding AI writing patterns that signal inauthenticity.

How do I install Writing For A Technical Audience in Claude Code?

Run `npx skills add ed3dai/ed3d-plugins --skill writing-for-a-technical-audience -a claude-code`. Or copy the skill folder (plugins/ed3d-house-style/skills/writing-for-a-technical-audience in ed3dai/ed3d-plugins) into .claude/skills/writing-for-a-technical-audience in your project. Claude Code loads it when a task matches its description.

How do I install Writing For A Technical Audience in Codex?

Run `npx skills add ed3dai/ed3d-plugins --skill writing-for-a-technical-audience -a codex`. Or copy the skill folder (plugins/ed3d-house-style/skills/writing-for-a-technical-audience in ed3dai/ed3d-plugins) into .agents/skills/writing-for-a-technical-audience in your project. Codex loads it when a task matches its description.

Can I use Writing For A Technical Audience 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 ed3dai/ed3d-plugins --skill writing-for-a-technical-audience -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-for-a-technical-audience, .gemini/skills/writing-for-a-technical-audience, .github/skills/writing-for-a-technical-audience and .opencode/skills/writing-for-a-technical-audience in your project.

What does Writing For A Technical Audience need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing For A Technical Audience is instructions for the agent only. Our summary lists: Python 3; Node.js; A credential in YOUR_API_KEY.

Does Writing For A Technical Audience 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 For A Technical Audience 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 For A Technical Audience use?

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

How many tokens does Writing For A Technical Audience use?

About 3.9k tokens (SKILL.md is roughly 15k 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 For A Technical Audience?

Skills that share tags, products or a category with Writing For A Technical Audience: Humanizer (Azure-Samples/interview-coach-agent-framework, 173 stars), Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars), User-Facing Text Cleanup (guillaumemeyer/watermarks-remover, 24k stars) and Install Anti Slop (trycompai/crm, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing For A Technical Audience?

ed3dai (a GitHub organization) maintains it in ed3dai/ed3d-plugins, which has 250 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on September 6, 2026.

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