Agent skill

Project Brief

by sd0xdev in sd0xdev/sd0x-harness

Convert a technical spec into a PM/CTO-readable executive summary.

MITAuto-check passedWriting & Content

Install Project Brief

skills CLI
$ npx skills add sd0xdev/sd0x-harness --skill project-brief -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sd0xdev/sd0x-harness project-brief --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sd0xdev/sd0x-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/project-brief .claude/skills/project-brief && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-brief
GitHub stars
192
Token cost
~721 tokens
SKILL.md length
182 words
Files
1
Skills in repo
91
Repo updated
First seen
Licence
MIT

At a glance

Convert a technical spec into a PM/CTO-readable executive summary.

  • Works in 4 steps: Read Technical Spec → Extract Key Information → Simplify Technical Details → …
  • Tasks that involve Summarization
  • SKILL.md covers Trigger, When NOT to Use, Agent Dispatch and Conversion Rules, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Project Brief is an agent skill from sd0xdev/sd0x-harness. Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Summarization. The repository describes itself as: The harness layer for Claude Code — a reference implementation of harness engineering with hook-enforced dual review, state-machine gates that survive context compaction, and… The licence is MIT.

When your agent uses it

  • Tasks that involve Summarization

Example prompts

  • “/project-brief”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Write, Agent

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Read Technical Spec
  2. Extract Key Information
  3. Simplify Technical Details
  4. Produce Executive Summary

What it can do on your machine

Read from SKILL.md and the folder at commit c9a2036. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Write
    • Agent

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Brief loads about 721 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 182 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~721

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sd0xdev/sd0x-harness at commit c9a2036, republished under its MIT licence (© sd0xdev). 182 words, ~721 tokens.

Download SKILL.mdSave it as .claude/skills/project-brief/SKILL.md (or your agent's skills folder).
name
project-brief
description
Convert a technical spec into a PM/CTO-readable executive summary. Simplify technical details, focus on business value.
allowed-tools
Read, Grep, Glob, Write, Agent

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 SectionPM/CTO Summary Treatment
Trust boundary diagramSimplify to 3-layer arch
Code analysisRemove
Reusable modulesRemove
System architectureKeep (simplified)
Implementation roadmapKeep
Key design decisionsRemove
Alternative comparisonKeep
Risks & mitigationsKeep
TimelineKeep
Immediate actionsSimplify 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

markdown
# [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.

© sd0xdev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/project-brief of sd0xdev/sd0x-harness.

Open the folder on GitHubat commit c9a2036

Compare with similar skills

Project Brief next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Brief this skillsd0xdev/sd0x-harness192—~721Automated safety check: PassMIT
News Aggregator Skillcclank/news-aggregator-skill1.3k—~2.1kAutomated safety check: PassNone
Vss Search ArchiveNVIDIA-AI-Blueprints/video-search-and-summarization1.9k—~3.6kAutomated safety check: PassApache-2.0
AI Daily Newsgeekjourneyx/ai-daily-skill235—~2.3kAutomated safety check: PassNone
AnalyzeriBigQiang/feedgrab613—~1kAutomated safety check: PassMIT
Reportmicrosoft/data-formulator18k—~1.5kAutomated safety check: PassMIT

Similar skills

  • News Aggregator Skill

    cclank/news-aggregator-skill

    Comprehensive news aggregator that fetches, filters, and deeply analyzes real-time content from 44+ sources including Hacker News, Lobsters, Dev.to, GitHub, arXiv, Hugging Face Papers, AIHOT, TLDR…

    1.3k GitHub stars~2.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Vss Search Archive

    NVIDIA-AI-Blueprints/video-search-and-summarization

    A skill your agent uses when a user wants to search archived VSS video or ingest or delete a source for search.

    1.9k GitHub stars~3.6k tokensUpdated today
    Writing & ContentAuto-check passed
  • AI Daily News

    geekjourneyx/ai-daily-skill

    Fetches AI news from smol.ai RSS and generates structured markdown with intelligent summarization and categorization.

    235 GitHub stars~2.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Analyzer

    iBigQiang/feedgrab

    Content Analyzer — any content (URL, text, transcript) into structured analysis report with actionable insights.

    613 GitHub stars~1k tokensUpdated 29 days ago
    Writing & ContentAuto-check passed
  • Report

    microsoft/data-formulator

    Official

    Turn an exploration (threads, findings, charts) into a single Markdown report — note, blog post, executive summary, KPI dashboard, slide brief, or multi-section analytical report, with embedded…

    18k GitHub stars~1.5k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Tldr

    earlyaidopters/claudeclaw

    Summarize the current conversation into a TLDR note and save it to your notes folder.

    173 GitHub stars~953 tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed

More from sd0xdev/sd0x-harness

All 91 skills in this repo
  • Adr

    sd0xdev/sd0x-harness

    Write an Architecture Decision Record (ADR) for a feature — Context / Decision / Status / Consequences / Alternatives, filed as docs/features/<feature/adr-<NNN-<title.md with a 3-digit zero-padded…

    192 GitHub stars~4.8k tokensUpdated yesterday
    Auto-check passed
  • Load PR Review

    sd0xdev/sd0x-harness

    Load GitHub PR review comments into AI session — analyze, triage, plan.

    192 GitHub stars~4.4k tokensUpdated yesterday
    Auto-check passed
  • Next Step

    sd0xdev/sd0x-harness

    Change-aware next step advisor. An agent skill from sd0xdev/sd0x-harness.

    192 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Obsidian CLI

    sd0xdev/sd0x-harness

    Obsidian vault integration via official CLI. An agent skill from sd0xdev/sd0x-harness.

    192 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Orchestrate

    sd0xdev/sd0x-harness

    Agent-driven workflow orchestration (v1 report-only). An agent skill from sd0xdev/sd0x-harness.

    192 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • PR Comment

    sd0xdev/sd0x-harness

    Post friendly review comments to a GitHub PR — prepare locally, preview, then submit as atomic review.

    192 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed

Questions about Project Brief

What does Project Brief do?

Convert a technical spec into a PM/CTO-readable executive summary. Project Brief is an agent skill from sd0xdev/sd0x-harness. Convert a technical spec into a PM/CTO-readable executive summary.

When should I use Project Brief?

Project Brief fits situations like: tasks that involve Summarization.

How do I install Project Brief in Claude Code?

Run `npx skills add sd0xdev/sd0x-harness --skill project-brief -a claude-code`. Or copy the skill folder (skills/project-brief in sd0xdev/sd0x-harness) into .claude/skills/project-brief in your project. Claude Code loads it when a task matches its description.

How do I install Project Brief in Codex?

Run `npx skills add sd0xdev/sd0x-harness --skill project-brief -a codex`. Or copy the skill folder (skills/project-brief in sd0xdev/sd0x-harness) into .agents/skills/project-brief in your project. Codex loads it when a task matches its description.

Can I use Project Brief in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sd0xdev/sd0x-harness --skill project-brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-brief, .gemini/skills/project-brief, .github/skills/project-brief and .opencode/skills/project-brief in your project.

What does Project Brief need to run?

SKILL.md names no scripts, command-line tools or credentials: Project Brief is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Write, Agent.

Does Project Brief access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Project Brief safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Project Brief use?

Project Brief is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Brief use?

About 721 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Brief?

Skills that share tags, products or a category with Project Brief: News Aggregator Skill (cclank/news-aggregator-skill, 1.3k stars), Vss Search Archive (NVIDIA-AI-Blueprints/video-search-and-summarization, 1.9k stars), AI Daily News (geekjourneyx/ai-daily-skill, 235 stars) and Analyzer (iBigQiang/feedgrab, 613 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Brief?

sd0xdev (a GitHub user) maintains it in sd0xdev/sd0x-harness, which has 192 GitHub stars. The repository holds 91 skills in this directory. The repository was last updated on October 6, 2026.

Source: sd0xdev/sd0x-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.