technical-writing SKILL.md skillA

technical-writing from bjornmelin/dev-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bjornmelin/dev-skills/technical-writing@v2.1.0

Pins v2.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bjornmelin/dev-skills
Path
skills/technical-writing/SKILL.md
Versions recorded
3
Latest version
v2.1.0, committed Jul 28, 2026
First version recorded
Apr 27, 2026
Size
9,937 bytes
Repository stars
8
License
none declared

Internal engineering docs: specs, ADRs, architecture, runbooks, migrations, rollout plans, and maintainer guides.

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

# Technical Writing

Use this skill when the deliverable is **internal technical documentation for builders and operators**.

`technical-writing` is the documentation-cluster anchor for:
- technical specs
- product requirements documents (PRDs)
- architecture docs
- ADRs / decision records
- runbooks and incident procedures
- rollout / rollback / migration guides
- developer-facing implementation or maintenance guides

## When to use this skill
- A team needs a technical spec before implementation starts
- A team needs a PRD for product/feature requirements before design or implementation
- An engineer needs an architecture document or ADR that records trade-offs and decisions
- Ops needs a runbook, rollback guide, or incident response procedure
- A migration or rollout needs a durable written path with validation and rollback notes
- A developer-facing internal guide needs to explain how a system works and how to work on it safely

## When not to use this skill

The lane is *internal* documentation. Say so and hand back when the real job is:

- **Published API, SDK, OpenAPI or developer-portal content** — an external
  reference surface with its own versioning and consumers.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bjornmelin/dev-skills/technical-writing@sha256:b272270e6a682358

The line at the top of this page pins the label v2.1.0, 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_y3uen4x3a3pf4rno.svg)](https://markdownregistry.com/a/art_y3uen4x3a3pf4rno)

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

Versions

The registry has recorded 3 versions of this file, between Apr 27, 2026 and Jul 28, 2026, about one every 46 days.

versioncommittedcommitsizeaudit
v2.1.0 latest2026-07-28 3aaa44b 9,937 BA view · diff
v2.1.02026-06-11 42704bf 8,799 BA view · diff
git:20260427.acce2712026-04-27 acce271 12,358 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 (9937 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

bjornmelin/dev-skills · 8 stars · license none declared · pushed 2026-10-27 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_y3uen4x3a3pf4rno
GET https://markdownregistry.com/api/v1/resolve?ref=bjornmelin/dev-skills/technical-writing
GET https://markdownregistry.com/api/v1/blob/b272270e6a682358267ac1f00c47efb7073b8fcf4ae5bc8eccd827c5bed7b391

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 bjornmelin/dev-skills

AGENTS.md AGENTS.md file
bjornmelin/dev-skills · AGENTS.md
git:20260805.c6b49e2 · audit A · 8 stars
browser-workbench-setup SKILL.md skill
bjornmelin/dev-skills · archive/skills/browser-workbench-setup/SKILL.md · Set up browser automation and UI QA for a new repository using playwright-interactive as the primary interactive tool…
git:20260730.da338fd · audit A · 8 stars
browser-workbench SKILL.md skill
bjornmelin/dev-skills · archive/skills/browser-workbench/SKILL.md · Browser/UI router--playwright-interactive, agent-browser, browser-workbench-setup. Triggers--UI debug, QA, screens…
git:20260730.da338fd · audit A · 8 stars
bun-audit SKILL.md skill
bjornmelin/dev-skills · archive/skills/bun-audit/SKILL.md · Shared Bun audit/remediation router. Use when auditing a repo for Bun-first correctness, explaining findings, listing…
git:20260720.59a58de · audit A · 8 stars
cleanup-py SKILL.md skill
bjornmelin/dev-skills · archive/skills/cleanup-py/SKILL.md · Python branch review—hard-cut, delete-first cleanup, Google docstrings.
git:20260728.3aaa44b · audit A · 8 stars
codex-session-cleanup SKILL.md skill
bjornmelin/dev-skills · archive/skills/codex-session-cleanup/SKILL.md · Safely scan, triage, quarantine, restore, and purge Codex session/history/state/memory artifacts for current repo…
git:20260728.3aaa44b · audit A · 8 stars
design-motion-system SKILL.md skill
bjornmelin/dev-skills · archive/skills/design-motion-system/SKILL.md · Cross-stack motion & design-system director. Use to turn vague "make it premium / cinematic / standout / hyperrealistic…
git:20260726.b67ae30 · audit A · 8 stars
dmc-py SKILL.md skill
bjornmelin/dev-skills · archive/skills/dmc-py/SKILL.md · Dash + DMC v2—MantineProvider, styles, Styles API, callbacks (pattern, clientside, bg), Pages, charts, modals, full…
git:20260729.efe35f4 · audit A · 8 stars
gh-deps-intel SKILL.md skill
bjornmelin/dev-skills · archive/skills/gh-deps-intel/SKILL.md · JS/TS + Python dep upgrade intel (monorepos). Outdated package-manager checks + GitHub release/changelog →…
git:20260803.4dcf273 · audit A · 8 stars
goal-to-release SKILL.md skill
bjornmelin/dev-skills · archive/skills/goal-to-release/SKILL.md · Orchestrate issue-backed goals from ambiguous request to shipped release with ledgers, adaptive PR graphs, preflight…
git:20260728.3aaa44b · audit A · 8 stars
kimi-ui-advisor SKILL.md skill
bjornmelin/dev-skills · archive/skills/kimi-ui-advisor/SKILL.md · Explicit-only Kimi Code CLI frontend/UI advisor for UI audits, redesigns, components, screenshots, before/after…
git:20260617.d1d0760 · audit A · 8 stars
managing-tech-debt SKILL.md skill
bjornmelin/dev-skills · archive/skills/managing-tech-debt/SKILL.md · Help users manage technical debt strategically. Use when someone is dealing with legacy code, planning refactoring…
git:20260728.3aaa44b · audit A · 8 stars

Every file in bjornmelin/dev-skills

Other files named technical-writing

technical-writing SKILL.md skill
cursor/plugins · pstack/skills/technical-writing/SKILL.md · Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global…
git:20261010.00b14f1 · audit A · 15,586 stars
technical-writing SKILL.md skill
cursor/plugins · harness/pstack/claude-code/skills/technical-writing/SKILL.md · Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global…
git:20261016.182f2ce · audit A · 15,586 stars
technical-writing SKILL.md skill
nightly-labs/openbot · marketplace/production-catalog/bundles/pstack/skills/technical-writing/SKILL.md · Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global…
git:20261013.9e6954c · audit A · 6,292 stars
technical-writing SKILL.md skill
michael-denyer/pstack-claude · plugins/pstack/skills/technical-writing/SKILL.md · Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global…
git:20261013.058a348 · audit A · 4,103 stars
technical-writing SKILL.md skill
backnotprop/pstack · skills/technical-writing/SKILL.md · Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global…
git:20261012.f3afb70 · audit A · 3,692 stars
technical-writing SKILL.md skill
rsmdt/the-startup · plugins/team/skills/development/technical-writing/SKILL.md · Create architectural decision records (ADRs), system documentation, API documentation, and operational runbooks. Use…
git:20260225.c94494b · audit A · 577 stars
technical-writing SKILL.md skill
openhands/extensions · skills/technical-writing/SKILL.md · Guides technical explanations toward flowing, direct, conversational prose. This skill should be used for engineering…
git:20260713.fc09aef · audit A · 179 stars
technical-writing SKILL.md skill
nahid-sparktales/agent-dispatcher · skills/knowledge/technical-writing/SKILL.md · Write or repair documentation that stays true to the system it describes — README, setup guide, how-to, API reference…
git:20260919.a0d4f55 · audit A · 58 stars

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