technical-writer SKILL.md skillA

technical-writer from widnyana/eyay-toolkits is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add widnyana/eyay-toolkits/technical-writer@git:20260829.6d9d2bb

Pins git:20260829.6d9d2bb in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
widnyana/eyay-toolkits
Path
plugins/prose-engineers/skills/technical-writer/SKILL.md
Versions recorded
2
Latest version
git:20260829.6d9d2bb, committed Aug 29, 2026
First version recorded
May 10, 2026
Size
12,248 bytes
Repository stars
8
License
MIT

This skill should be used when the user asks to "write a blog post", "draft a postmortem", "document this process", "write an incident writeup", "review this article", "write API docs", "write a how-to guide", "compare these two tools", "write up this feature", "make this scannable", "restructure this draft", or "nobody finishes reading this". Produces technical writing that is problem-first, concrete, and humble: real numbers instead of adjectives, real incidents instead of invented…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Approachable Technical Writer

Writing for people who ship things. They don't need theory or marketing language —
they need to know what matters, why it breaks, and how to fix it. They also want the
human part: why this was discovered, what it cost, where the traps are.

## Workflow

1. **Find the problem.** Before drafting, identify what breaks or costs something if
   the reader ignores this. If that can't be named, stop and ask the user — a piece
   without a problem has no opening.
2. **Collect the real material.** Actual numbers, actual code, actual incidents. Ask
   the user for specifics rather than inventing plausible ones. Missing evidence is a
   gap to acknowledge, not to fill.
3. **Pick a pattern.** Load `references/patterns.md` and choose the template matching
   the piece type (default, how-to, review, explanation, postmortem).
4. **Draft in plain text.** Structure and words first; Markdown, HTML, or vault
   formatting later.
5. **Run the checklist.** Every item at the bottom of this file, before handing back.

Default to public-facing mode. Switch to internal mode when the user says "internal"
or "for the team".

## Core principles

### 1. Problem first
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add widnyana/eyay-toolkits/technical-writer@sha256:a733c40be9303755

The line at the top of this page pins the label git:20260829.6d9d2bb, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_g7bdqdujbzki2yfh.svg)](https://markdownregistry.com/a/art_g7bdqdujbzki2yfh)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between May 10, 2026 and Aug 29, 2026, about one every 111 days.

versioncommittedcommitsizeaudit
git:20260829.6d9d2bb latest2026-08-29 6d9d2bb 12,248 BA view · diff
git:20260510.b02852b2026-05-10 b02852b 12,672 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12248 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

widnyana/eyay-toolkits · 8 stars · license MIT · pushed 2026-10-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g7bdqdujbzki2yfh
GET https://markdownregistry.com/api/v1/resolve?ref=widnyana/eyay-toolkits/technical-writer
GET https://markdownregistry.com/api/v1/blob/a733c40be930375559b9fe3840347484de55f7a3ef62e3d76619cb24b49d1ee5

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from widnyana/eyay-toolkits

AGENTS.md AGENTS.md file
widnyana/eyay-toolkits · AGENTS.md
git:20260901.0ef5820 · audit B · 8 stars
CLAUDE.md CLAUDE.md file
widnyana/eyay-toolkits · CLAUDE.md
git:20261016.58e0f40 · audit A · 8 stars
AGENTS.md@pi-packages AGENTS.md file
widnyana/eyay-toolkits · pi-packages/AGENTS.md
git:20261016.58e0f40 · audit A · 8 stars
CLAUDE.md@pi-packages CLAUDE.md file
widnyana/eyay-toolkits · pi-packages/CLAUDE.md
git:20261007.2d27ab1 · audit B · 8 stars
design-graph SKILL.md skill
widnyana/eyay-toolkits · pi-packages/design-thinking/skills/design-graph/SKILL.md · Design Graph: the interface method. Job → Flow → Surface<C, V, N>: surfaces, content (C), void states (V: empty…
git:20261023.1e662bc · audit A · 8 stars
design-thinking SKILL.md skill
widnyana/eyay-toolkits · pi-packages/design-thinking/skills/design-thinking/SKILL.md · Design Thinking: the code method. X → Graph → Effect<A, E, R>, the §1-§10 pipeline: shapes, happy path (A)…
git:20261023.1e662bc · audit A · 8 stars
graph-protocol SKILL.md skill
widnyana/eyay-toolkits · pi-packages/design-thinking/skills/graph-protocol/SKILL.md · Graph Protocol: the orchestration method. X → Graph → Delegation<A, E, R>: task nodes, execution graph in waves…
git:20261023.1e662bc · audit A · 8 stars
pi-coordinator SKILL.md skill
widnyana/eyay-toolkits · pi-packages/pi-coordinator/skills/pi-coordinator/SKILL.md · Run as coordinator that plans a job, hands each coding task to a sub-agent worker (pi Agent tool / omp task agent)…
git:20261017.4c68d09 · audit A · 8 stars
AGENTS.md@plugins AGENTS.md file
widnyana/eyay-toolkits · plugins/AGENTS.md
git:20261023.f1974be · audit A · 8 stars
bmad-sprint-run SKILL.md skill
widnyana/eyay-toolkits · plugins/bmad-sprint-run/skills/bmad-sprint-run/SKILL.md · This skill should be used when the user says "run the sprint", "autonomous sprint", "run all stories", "execute sprint…
v1.0.0 · audit A · 8 stars
cover-letter-builder SKILL.md skill
widnyana/eyay-toolkits · plugins/career-tools/skills/cover-letter-builder/SKILL.md · Build a tailored cover letter from a CV or resume (PDF, plain text, Markdown, LaTeX, or a file path) matched to a job…
git:20260502.f8779e0 · audit A · 8 stars
cv-builder SKILL.md skill
widnyana/eyay-toolkits · plugins/career-tools/skills/cv-builder/SKILL.md · Build or update a Curriculum Vitae (CV) by scanning a repo for the person's background (experience, skills, education…
git:20260502.f8779e0 · audit A · 8 stars

Every file in widnyana/eyay-toolkits

Other files named technical-writer

technical-writer SKILL.md skill
vercel-labs/fx · .fx/skills/technical-writer/SKILL.md · Write, review, and edit developer documentation for SDKs, libraries, and frameworks, including sites such as ai-sdk.dev…
v1.3 · audit A · 3,489 stars
technical-writer SKILL.md skill
codeaholicguy/ai-devkit · skills/technical-writer/SKILL.md · AI DevKit · Review and improve documentation for novice users. Use when users ask to review docs, improve…
git:20260509.950097b · audit A · 1,648 stars
technical-writer SKILL.md skill
onewave-ai/claude-skills · technical-writer/SKILL.md · Write comprehensive technical documentation including user guides, how-to articles, system architecture docs…
git:20260608.d82d20f · audit A · 358 stars

Browse by kind, by grade A, or by owner.