writing-specs-designs

Create technical specs, feature specs, and design briefs with YAML frontmatter.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/Andy-HNU/AndyClaw --skill writing-specs-designs-andy-hnu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-specs-designs
Source: https://github.com/Andy-HNU/AndyClaw/tree/main/skills/lenny-writing-specs-designs
Command: npx skills add https://github.com/Andy-HNU/AndyClaw --skill writing-specs-designs-andy-hnu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps teams write effective specs and design documents to align product, design, and engineering, reducing ambiguities that derail development.

Core Features & Use Cases

  • Framework and prompts derived from insights from seven product leaders to structure thinking and collaboration.
  • Guidance for creating technical specs, feature specs, design briefs, and product requirements communications across cross-functional teams.
  • Includes questions, common pitfalls, and best practices to improve clarity, alignment, and fast decision-making.

Quick Start

Draft a concise product spec following the seven-guest framework outlined in this skill.

Frequently Asked Questions about writing-specs-designs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a product spec that aligns engineering and design teams?

Write a product spec by applying a seven-guest framework that provides specific questions and best practices to reduce ambiguities. This approach structures cross-functional collaboration to align engineering, product, and design teams.

What is the best way to structure a technical spec for cross-functional teams?

The best way to structure a technical spec for cross-functional teams is using a YAML frontmatter for metadata and a Markdown body for operational instructions. This framework incorporates common pitfalls and best practices to ensure clarity and fast decision-making.

Does this spec writing framework support both feature specs and design briefs?

Yes, this spec writing framework supports creating feature specs, design briefs, technical specs, and product requirements communications. It provides guidance derived from product leaders to improve alignment across cross-functional teams.

How do I avoid common pitfalls when drafting product requirements communications?

Avoid common pitfalls in product requirements communications by following a structured framework that highlights best practices and specific questions. This skill provides operational instructions in a Markdown body to guide fast decision-making and reduce development-derailing ambiguities.

Can I use YAML frontmatter to manage technical specs and design documents?

Yes, you can use YAML frontmatter with mandatory name and description fields to manage technical specs and design documents. The framework supports this metadata structure alongside a Markdown body providing operational instructions for cross-functional alignment.