writing-skills SKILL.md skillA

writing-skills from ed3dai/ed3d-plugins is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ed3dai/ed3d-plugins/writing-skills@git:20260204.611bfd1

Pins git:20260204.611bfd1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ed3dai/ed3d-plugins
Path
plugins/ed3d-extending-claude/skills/writing-skills/SKILL.md
Versions recorded
3
Latest version
git:20260204.611bfd1, committed Feb 4, 2026
First version recorded
Jan 15, 2026
Size
5,033 bytes
Repository stars
253
License
none declared

Use when creating new skills, editing existing skills, or verifying skills work before deployment - applies TDD to process documentation by testing with subagents before writing, iterating until bulletproof against rationalization.

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

# Writing Skills

**REQUIRED BACKGROUND:** Read ed3d-extending-claude:writing-claude-directives for foundational guidance on token efficiency, discovery optimization, and compliance techniques. This skill focuses on TDD methodology specific to skill creation.

## Core Principle

**Writing skills IS Test-Driven Development applied to process documentation.**

Write test cases (pressure scenarios), watch them fail (baseline behavior), write the skill, watch tests pass, refactor (close loopholes).

**Iron Law:** No skill without a failing test first. Same as TDD for code.

## TDD Mapping

| TDD Concept | Skill Creation |
|-------------|----------------|
| Test case | Pressure scenario with subagent |
| Production code | SKILL.md document |
| RED | Agent violates rule without skill |
| GREEN | Agent complies with skill present |
| Refactor | Close loopholes, re-test |

## When to Create a Skill

**Create when:**
- Technique wasn't intuitively obvious
- You'd reference this across projects
- Pattern applies broadly
- Others would benefit

**Don't create for:**
- One-off solutions
- Standard practices documented elsewhere
- Project-specific conventions (use CLAUDE.md)

## Skill Types
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ed3dai/ed3d-plugins/writing-skills@sha256:d7528be044ca2cfd

The line at the top of this page pins the label git:20260204.611bfd1, 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_5gfsxgj4wflsk57a.svg)](https://markdownregistry.com/a/art_5gfsxgj4wflsk57a)

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

Versions

The registry has recorded 3 versions of this file, between Jan 15, 2026 and Feb 4, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
git:20260204.611bfd1 latest2026-02-04 611bfd1 5,033 BA view · diff
git:20260123.05d7f8d2026-01-23 05d7f8d 5,011 BA view · diff
git:20260115.cf17c552026-01-15 cf17c55 4,960 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 (5033 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

ed3dai/ed3d-plugins · 253 stars · license none declared · pushed 2026-09-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5gfsxgj4wflsk57a
GET https://markdownregistry.com/api/v1/resolve?ref=ed3dai/ed3d-plugins/writing-skills
GET https://markdownregistry.com/api/v1/blob/d7528be044ca2cfdf498a104af90824d88013ed8ab02dbef28c2e88d1aa5646f

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 ed3dai/ed3d-plugins

CLAUDE.md CLAUDE.md file
ed3dai/ed3d-plugins · CLAUDE.md
git:20260116.da03082 · audit A · 253 stars
doing-a-simple-two-stage-fanout SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-basic-agents/skills/doing-a-simple-two-stage-fanout/SKILL.md · Use when analyzing a large corpus of text, code, or data that exceeds a single agent's effective context - orchestrates…
git:20260616.eb1d79c · audit A · 253 stars
using-generic-agents SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-basic-agents/skills/using-generic-agents/SKILL.md · Use to decide what kind of generic agent you should use
git:20260204.611bfd1 · audit A · 253 stars
creating-a-plugin SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/creating-a-plugin/SKILL.md · Use when creating a new Claude Code plugin or setting up plugin structure - provides complete file organization…
git:20260204.611bfd1 · audit A · 253 stars
creating-an-agent SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/creating-an-agent/SKILL.md · Use when creating specialized subagents for Claude Code plugins or the Task tool - covers description writing for…
git:20260204.611bfd1 · audit A · 253 stars
maintaining-a-marketplace SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/maintaining-a-marketplace/SKILL.md · Use when creating, releasing, or maintaining a Claude Code Plugin Marketplace - covers marketplace.json schema, version…
git:20260216.3c056d6 · audit A · 253 stars
maintaining-project-context SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/maintaining-project-context/SKILL.md · Use when completing development phases or branches to identify and update CLAUDE.md or AGENTS.md files that may have…
git:20260204.611bfd1 · audit A · 253 stars
prompt-security-hardening SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/prompt-security-hardening/SKILL.md · Use when writing skills, CLAUDE.md files, agent prompts, or any directives that involve shell commands, environment…
git:20260319.b0d6d88 · audit A · 253 stars
testing-skills-with-subagents SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/testing-skills-with-subagents/SKILL.md · Use when creating or editing skills, before deployment, to verify they work under pressure and resist rationalization -…
git:20260214.3e7e26e · audit A · 253 stars
writing-claude-directives SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/writing-claude-directives/SKILL.md · Use when writing instructions that guide Claude behavior - skills, CLAUDE.md files, agent prompts, system prompts…
git:20260319.b0d6d88 · audit A · 253 stars
writing-claude-md-files SKILL.md skill
ed3dai/ed3d-plugins · plugins/ed3d-extending-claude/skills/writing-claude-md-files/SKILL.md · Use when creating or updating CLAUDE.md files for projects or subdirectories - covers top-level vs domain-level…
git:20260204.611bfd1 · audit A · 253 stars
CLAUDE.md@plugins/ed3d-house-style CLAUDE.md file
ed3dai/ed3d-plugins · plugins/ed3d-house-style/CLAUDE.md
git:20260115.cf17c55 · audit A · 253 stars

Every file in ed3dai/ed3d-plugins

Other files named writing-skills

writing-skills SKILL.md skill
obra/superpowers · skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment
git:20261021.2ce8aa1 · audit A · 309,852 stars
writing-skills SKILL.md skill
jnmetacode/superpowers-zh · skills/writing-skills/SKILL.md · 当创建新技能、编辑现有技能或在部署前验证技能是否有效时使用
v1.0.0 · audit A · 8,456 stars
writing-skills SKILL.md skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment.
git:20260601.da7723a · audit A · 1,891 stars
writing-skills SKILL.md skill
ganyuanran/aegis · skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment
git:20260920.8265b5c · audit A · 1,408 stars
writing-skills SKILL.md skill
coco-research/coco · skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment
git:20260802.1479e32 · audit A · 796 stars
writing-skills SKILL.md skill
xu123-bob/baize · agent/skills/superpowers/5.1.0/skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment
git:20260912.5e131e8 · audit A · 590 stars
writing-skills SKILL.md skill
jamditis/claude-skills-journalism · superjawn/skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment
git:20261024.21f0bb2 · audit A · 447 stars
writing-skills SKILL.md skill
ibrahim-3d/orchestrator-supaconductor · skills/writing-skills/SKILL.md · Use when creating new skills, editing existing skills, or verifying skills work before deployment
git:20260327.39c77f1 · audit A · 381 stars

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