Writing Tech Specs

Use when writing or revising an HTML-first technical design package, technical plan, implementation plan, workflow plan, process flow plan, migration plan, rollout plan, cutover plan, RFC, architecture spec, interface contract, schema, state machine, or implementation spec for engineers or the next coding agent.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add yin52133/codex-write-specs --skill writing-tech-specs
Manual install
git clone --depth 1 https://github.com/yin52133/codex-write-specs.git /tmp/codex-write-specs
mkdir -p ~/.claude/skills
cp -r /tmp/codex-write-specs/plugins/codex-write-specs/skills/writing-tech-specs ~/.claude/skills/writing-tech-specs

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Writing Technical Specs And Plans

## Overview

Write specs and plans that let an implementer start work without guessing.

This skill is guidance, not a repository-local file policy. Follow the current project's canonical docs, filenames, and section layout when they already work. Introduce new structure only when the existing structure is missing, misleading, or explicitly in scope to change.

Generalized does not mean structure-free. When a project does not already have a good canonical shape, this skill still expects a standard package, standard section discipline, and explicit review gates so the spec normalizes the request into a buildable design.

Default new design output is HTML. Markdown is a legacy fallback for existing Markdown-only canonical docs, explicit user requests, or review systems that cannot render HTML. Execution checklists remain JSON.

Plans must be goal-driven. Each implementation slice needs an explicit goal, the smallest necessary change boundary, and a verification signal that can pass or fail.

## Truthfulness and Failure Semantics

Be factual. Do not add user-pleasing filler or write a smoother design than the real constraints support.

If a requested requirement is inconsistent, unsafe, underspecified, or technically wrong:
- say so directly
- mark the broken assumption, boundary, or risk
- ask for the missing decision or change the design explicitly
- do not paper over the problem with vague compatibility language
Read the full skill on GitHub

Details

Skill name
writing-tech-specs
Path
plugins/codex-write-specs/skills/writing-tech-specs/SKILL.md
License
MIT
Repo updated
17 May 2026

FAQ

What does the Writing Tech Specs skill do?

Use when writing or revising an HTML-first technical design package, technical plan, implementation plan, workflow plan, process flow plan, migration plan, rollout plan, cutover plan, RFC, architecture spec, interface contract, schema, state machine, or implementation spec for engineers or the next coding agent.

How do I install the Writing Tech Specs skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add yin52133/codex-write-specs --skill writing-tech-specs. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Writing Tech Specs popular?

It lives in yin52133/codex-write-specs, which has 43 GitHub stars and 0 forks.

Related skills

Aeo Strategy

79

LeadMagic/gtm-skills

Builds an answer engine optimization (AEO/GEO) plan so content gets cited by ChatGPT, Perplexity, Gemini, Claude, and Google AI Overviews: answer-first structure, entity coverage, citation-worthy data, and AI-visibility measurement. Use when the user wants to rank in AI search results or get their brand cited by AI assistants. Triggers on: "AEO", "answer engine optimization", "AI search", "generative engine optimization", "GEO", "optimize for AI search", "get cited by ChatGPT".

Writing & ContentIn 1 list18

Linkedin Resume Optimizer

43

KBRmau/linkedin-resume-optimizer

Coleta os dados de um perfil do LinkedIn (headline, about, top skills, experiências, educação) e do currículo, e devolve uma versão otimizada para a área de atuação desejada, com foco em busca de recrutador, densidade de palavras-chave e bullets orientados a resultado. Use quando o usuário pedir para "otimizar meu linkedin", "melhorar meu currículo", "revisar meu perfil profissional" ou similar.

Writing & Content

AI Content Creation

79

LeadMagic/gtm-skills

AI-powered content creation workflows — step-by-step processes for using Claude, ChatGPT, Jasper, Copy.ai, Writesonic, and Perplexity to generate, edit, and optimize blog posts, social media content, email sequences, ad copy, landing page copy, and SEO content. Use when scaling content production, building an AI-assisted content pipeline, or teaching non-writers to produce high-quality content with AI. Triggers on: "AI content", "ChatGPT for blog", "AI copywriting", "scale content with AI".

Writing & ContentIn 1 list18

Editorial Designer

43

heyman333/atelier-ui

Create distinctive, production-grade frontend interfaces with high editorial design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

Writing & Content

Content Distribution

79

LeadMagic/gtm-skills

Distribute content across channels for maximum reach — multi-platform repurposing, syndication, paid amplification, email distribution, and partner promotion. Use when getting content in front of an audience, repurposing content, or building a distribution engine. Triggers on: "content distribution", "promote content", "repurpose content", "syndication", "amplify content", "get more eyes on", or any content amplification request.

Writing & ContentIn 1 list18

Winnie the Pooh

55

surendranb/writing-skills

Write gentle, unhurried, childlike-wisdom prose in the voice of Winnie the Pooh. Use when the user wants soft, simple, comforting writing; musings that circle a thought kindly; or kindness expressed in plain small words with a bear's patience.

Writing & ContentIn 1 list

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.