project-brief
Skill192 starsChanged 37 days agoMITView on GitHub
Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.
10 other projects use a version of this.
Adopted by
Most recently taken up by
- Git-FED/MuseAi-Skills-Guidetheir own version, first seen Nov 8, 2026
- Rome-1/obsidian-claude-startertheir own version, first seen Nov 1, 2026
- DoKu67/claude-code-skilstheir own version, first seen Oct 16, 2026
- anhvu3594/claude-skillstheir own version, first seen Oct 15, 2026
- hmj1026/dhpktheir own version, first seen Oct 13, 2026
- sd0xdev/sd0x-harnessword for word, first seen Oct 6, 2026
Other versions10 projects use a version of this.
Word for word · 1
- sd0xdev/sd0x-harness★ 192100% same
Edited · 0
None found.
Wrote their own version · 9
- Git-FED/MuseAi-Skills-Guide★ 121same name
- zrosenfield/sharepoint-ai-skills★ 96same name
- flurdy/agent-skills★ 9same name
- MarcoZorn/agencykit★ 6same name
- Rome-1/obsidian-claude-starter★ 5same name
- DoKu67/claude-code-skils★ 4same name
- erendevelops/erendev-claude-skills★ 2same name
- hmj1026/dhpk★ 2same name
- anhvu3594/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository102 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- adrSkill
- agentctl-setupSkill
- architectureSkill
- askSkill
- best-practicesSkill
- bug-fixSkill
- bump-versionSkill
- check-coverageSkill
- claude-healthSkill
- code-exploreSkill
- code-investigateSkill
- codex-architectSkill
- codex-brainstormSkill
- codex-cli-reviewSkill
- codex-code-reviewSkill
- codex-explainSkill
- codex-implementSkill
- codex-review-branchSkill
- codex-review-docSkill
- codex-review-fastSkill
- codex-reviewSkill
- codex-securitySkill
- codex-setupSkill
- codex-test-genSkill
- codex-test-reviewSkill
- contract-decodeSkill
- create-prSkill
- create-requestSkill
- de-ai-flavorSkill
- debugSkill
- deep-analyzeSkill
- deep-exploreSkill
- deep-researchSkill
- dep-auditSkill
- deploy-flowSkill
- dev-security-auditSkill
- doc-refactorSkill
- doc-reviewSkill
- epic-mergeSkill
- feasibility-studySkill
- feature-devSkill
- feature-verifySkill
- fp-briefSkill
- generate-runnerSkill
- gh-stackSkill
- git-investigateSkill
- git-profileSkill
- install-hooksSkill
- install-rulesSkill
- install-scriptsSkill
- issue-analyzeSkill
- jiraSkill
- load-pr-reviewSkill
- merge-prepSkill
- necessity-auditSkill
- next-stepSkill
- obsidian-cliSkill
- op-sessionSkill
- orchestrateSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 4 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 9 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 17
Document review (use /codex-review-doc)
- Distinctive: line 55
Read the specified tech spec file
- Distinctive: line 70
Remove internal module names
- Distinctive: line 71
Remove technical implementation details
- Distinctive: line 72
Keep business logic descriptions
- Very specific: line 119
If $ARGUMENTS contains --output <path>, save to the specified location.
“Common” is measured: kept by at least 6 in 10 of the 9 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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
$ARGUMENTSConversion 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

