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
npx skills add yin52133/codex-write-specs --skill writing-tech-specsgit 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-specsPersonal 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
Details
- Skill name
writing-tech-specs- Repository
- yin52133/codex-write-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
79LeadMagic/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".
Linkedin Resume Optimizer
43KBRmau/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.
AI Content Creation
79LeadMagic/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".
Editorial Designer
43heyman333/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.
Content Distribution
79LeadMagic/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.
Winnie the Pooh
55surendranb/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.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.