brief-writer

Convert one-sentence intents into structured work briefs with YAML frontmatter and acceptance criteria.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Kiwi-Home/ai-workflow --skill brief-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brief-writer
Source: https://github.com/Kiwi-Home/ai-workflow/tree/main/plugins/structured-workflows/skills/brief-writer
Command: npx skills add https://github.com/Kiwi-Home/ai-workflow --skill brief-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transform short, informal intent statements into complete, structured work briefs that can drive design, implementation, and review pipelines while reducing ambiguity and rework.

Core Features & Use Cases

  • Load domain-specific brief templates from workflow.yaml or fallback template files and populate each section with focused content.
  • Analyze a one-line intent to extract subject, action, scope, and stakeholders, then convert implicit requirements into measurable acceptance criteria.
  • Persist briefs using an atomic local write protocol with slug collision handling or create GitHub issues when configured for tracked workflows.

Quick Start

Run /structured-workflows:define with a one-sentence intent such as "Add user-facing rate limit and retry behavior to the payments API".

Frequently Asked Questions about brief-writer

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

FAQPage Schema
How do I convert a one-sentence intent into a full structured work brief?

To convert a one-sentence intent into a structured work brief, the system analyzes the statement to extract subject, action, scope, and stakeholders. It then populates domain-specific templates with focused content and converts implicit requirements into measurable acceptance criteria.

What is the best way to generate project briefs with measurable acceptance criteria from a short intent?

The best way to generate project briefs from short intents is to use an automated expansion tool that loads domain-specific templates and translates implicit requirements into measurable acceptance criteria. This approach reduces ambiguity and rework by enforcing completeness validation before presenting the brief.

How do I create GitHub issues from a one-line intent automatically?

You can create GitHub issues from a one-line intent by configuring tracked workflows within your project setup. The system processes the intent into a structured brief and persists it directly as a GitHub issue instead of using local file storage.

Does the structured brief generation work with custom workflow templates?

Yes, structured brief generation works with custom workflow templates by loading domain-specific brief templates from your workflow.yaml file. If specific templates are not configured there, it falls back to loading template files from the templates directory.

How does the brief writer handle slug collisions when saving files locally?

To handle slug collisions during local saves, the system enforces unique kebab-case slugs using an atomic write protocol. This mechanism ensures file integrity and prevents data overwrites when multiple briefs are generated.

Why does my project need YAML frontmatter metadata in generated work briefs?

Your project needs YAML frontmatter metadata in generated work briefs to provide structured, machine-readable context for downstream design and implementation pipelines. This metadata enables consistent tracking and integration within automated project workflows.