How do I install the Write Design Doc skill?

Run npx skillmds@latest add marin-community/write-design-doc in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Write Design Doc safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Write Design Doc?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Write Design Doc free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Write Design Doc?

marin-community (@marin-community) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Write Design Doc by marin-community

Name: Write Design Doc
Author: marin-community

Write Design Doc

Publish or revise a concise cross-project design proposal in Echo. Use for an explicit design task or a design-level change whose context, decision, interfaces, tradeoffs, and rollout need review without adding a repository design document.

File contents

Skill: Write Design Doc

Invoke consult-echo and inspect the current checkout before drafting. Edit the closest existing design when the same decision is continuing; add a new entry only for a distinct design.

Write a compact Open Knowledge Format document in a temporary file:

---
type: wiki-note
title: <Concrete decision or proposal>
use_when: when <future task should load this design>
tags:
  - design
  - <repo-or-subsystem>
---

## Context

<Constraint, observed problem, and evidence links.>

## Decision

<Interfaces, invariants, ownership, and important alternatives.>

## Validation and rollout

<How the design will be tested, introduced, observed, and reversed if needed.>

Keep it near one page. Include code only when it resolves an interface or data model ambiguity. State material risks and unresolved choices plainly.

Publish the design:

uv run .agents/skills/consult-echo/scripts/echo.py wiki add --file /tmp/<design>.md
uv run .agents/skills/consult-echo/scripts/echo.py wiki edit <id> --file /tmp/<design>.md

Return the canonical Echo URL and link it from the coordinating issue or PR. Do not add a parallel file under .agents/projects/ or docs/ unless the user explicitly requests a repository-owned specification.

Frequently asked questions