Agent skill
project-brief
Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.
Install this agent skill to your Project
npx add-skill https://github.com/sd0xdev/sd0x-dev-flow/tree/main/skills/project-brief
SKILL.md
Project Brief
Trigger
- Keywords: executive summary, project brief, PM summary, CTO summary, project-brief
When NOT to Use
- First-principles briefing (use
/fp-brief) - Technical spec writing (use
/tech-spec) - Document review (use
/codex-review-doc)
Agent Dispatch
Agent({
description: "Convert technical spec into PM/CTO executive summary",
subagent_type: "brief-writer",
prompt: `Convert the following tech spec into a PM/CTO-readable executive summary.
Follow the conversion rules and execution flow defined in this skill.`
})
Input
$ARGUMENTS
Conversion Rules
| Tech Spec Section | PM/CTO Summary Treatment |
|---|---|
| Trust boundary diagram | Simplify to 3-layer arch |
| Code analysis | Remove |
| Reusable modules | Remove |
| System architecture | Keep (simplified) |
| Implementation roadmap | Keep |
| Key design decisions | Remove |
| Alternative comparison | Keep |
| Risks & mitigations | Keep |
| Timeline | Keep |
| Immediate actions | Simplify to decision points |
Execution Flow
Step 1: Read Technical Spec
- Read the specified tech spec file
- Identify the core value proposition
Step 2: Extract Key Information
- Project overview: one sentence on what, why, and value
- Current state vs target comparison
- Solution evaluation (keep pros/cons comparison)
- Milestone timeline
- Risk summary
- Resource requirements
Step 3: Simplify Technical Details
- Remove code snippets
- Remove internal module names
- Remove technical implementation details
- Keep business logic descriptions
Step 4: Produce Executive Summary
Output
# [Project Name] Executive Summary
## Project Overview
> One sentence: what, why, and value
## Current State vs Target
| Dimension | Current | Target |
|-----------|---------|--------|
## Solution Evaluation
| Solution | Pros | Cons | Recommendation |
|----------|------|------|----------------|
## Architecture Overview
(Simplified system diagram, 3 layers max)
## Milestones
| Week | Deliverable | Dependencies |
|------|-------------|--------------|
## Risk Summary
| Risk | Impact Level | Mitigation |
|------|-------------|------------|
## Resource Requirements
- **Headcount**:
- **Timeline**:
- **External Dependencies**:
## Decision Points
> Items requiring PM/CTO decision
- [ ] Decision 1:
- [ ] Decision 2:
Save
By default, save to the same directory as the original file with a -brief suffix.
Example: docs/features/xxx/architecture.md -> docs/features/xxx/architecture-brief.md
If $ARGUMENTS contains --output <path>, save to the specified location.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
runbook
Generate and update feature release runbooks from existing docs and codebase. Use when: creating operational runbook, release handbook, deployment checklist, pre-release preparation. Not for: incident response (v2), code review (use codex-code-review), architecture design (use architecture).
ask
Context-aware Q&A with auto context gathering. Use when: user has a quick question about codebase, git history, rules, docs, or skills during development. Not for: code changes (use feature-dev), code review (use codex-review-fast), deep research (use deep-research), full code trace (use code-explore). Output: structured answer with source attribution.
codex-test-gen
Generate unit tests for specified functions using Codex MCP
bug-fix
Bug fix workflow. Use when: fixing bugs, resolving issues, regression fixes. Not for: new features (use feature-dev), understanding code (use code-explore). Output: fix + regression test + review gate.
skill-health-check
Validate skill quality against routing, progressive loading, and verification criteria. Use when: auditing skills, checking skill health, reviewing skill design. Not for: code review (use codex-code-review) or doc review (use doc-review). Output: health report with per-skill ratings + Gate.
doc-refactor
Refactor documents — simplify without losing information, visualize flows with sequenceDiagram.
Didn't find tool you were looking for?