Agent skill

Write Spec

by AlexPEClub in AlexPEClub/ai-coding-starter-kit

Write a full feature spec for a feature. An agent skill from AlexPEClub/ai-coding-starter-kit.

No licenceAuto-check passedProduct & Project Management

Install Write Spec

skills CLI
$ npx skills add AlexPEClub/ai-coding-starter-kit --skill write-spec -a claude-code

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

GitHub CLI
$ gh skill install AlexPEClub/ai-coding-starter-kit write-spec --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/AlexPEClub/ai-coding-starter-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/write-spec .claude/skills/write-spec && 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
write-spec
GitHub stars
382
Token cost
~1.9k tokens
SKILL.md length
997 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
None found

At a glance

Write a full feature spec for a feature. An agent skill from AlexPEClub/ai-coding-starter-kit.

  • Works in 4 steps: Read docs/PRD.md — understand the… → Read features/INDEX.md — see existing… → Check existing components: git ls-files… → …
  • Tasks that involve PRD writing
  • SKILL.md covers Role, The Grill Me Principle, Before Starting and Three Entry Points, plus 9 more sections
  • Calls git

What it does

Write Spec is an agent skill from AlexPEClub/ai-coding-starter-kit. Write a full feature spec for a feature. Works for features already on the roadmap (status "Roadmap" from /init) and for features added later. Pass a feature name or PROJ-X ID as argument.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `template.md`).

It sits in Product & Project Management, covering PRD writing. The repository describes itself as: Production-ready Next.js template with AI-powered development workflow using 6 specialized agents.

When your agent uses it

  • Tasks that involve PRD writing

Example prompts

  • “Roadmap”
  • “/write-spec”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read docs/PRD.md — understand the project vision and target users
  2. Read features/INDEX.md — see existing features, find the next available PROJ-X ID, check for duplicates
  3. Check existing components: git ls-files src/components/
  4. Check existing APIs: git ls-files src/app/api/

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Write Spec loads about 1.9k tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 997 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 997 words (~1,875 tokens).

“You are an experienced Product Manager. Your job is to turn a feature idea into a complete, testable specification — with user stories, acceptance criteria, and edge cases.”

— opening of SKILL.md by AlexPEClub
name
write-spec
argument-hint
feature name or PROJ-X ID
user-invocable
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .claude/skills/write-spec of AlexPEClub/ai-coding-starter-kit.

  • SKILL.md
  • template.md

Open the folder on GitHubat commit 21a97bb

Compare with similar skills

Write Spec 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.

Write Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Write Spec this skillAlexPEClub/ai-coding-starter-kit382—~1.9kAutomated safety check: PassNone
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
Ralph Tui Create JSONsubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Prd Generator

    jamesrochabrun/skills

    Generate comprehensive Product Requirements Documents (PRDs) for product managers.

    216 GitHub starsUsed in 2 repos~3.8k tokens
    Product & Project ManagementAuto-check passed

More from AlexPEClub/ai-coding-starter-kit

All 8 skills in this repo
  • Init

    AlexPEClub/ai-coding-starter-kit

    Initialize a new project. An agent skill from AlexPEClub/ai-coding-starter-kit.

    382 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • Refine

    AlexPEClub/ai-coding-starter-kit

    Always use when the user wants to discuss an exsiting feature or specification.

    382 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Architecture

    AlexPEClub/ai-coding-starter-kit

    Design PM-friendly technical architecture for features. An agent skill from AlexPEClub/ai-coding-starter-kit.

    382 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Backend

    AlexPEClub/ai-coding-starter-kit

    Build APIs, database schemas, and server-side logic with Supabase.

    382 GitHub stars~992 tokensUpdated 4 mo ago
    Auto-check passed
  • Deploy

    AlexPEClub/ai-coding-starter-kit

    Deploy to Vercel with production-ready checks, error tracking, and security headers setup.

    382 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check: notes
  • Frontend

    AlexPEClub/ai-coding-starter-kit

    Build UI components with React, Next.js, Tailwind CSS, and shadcn/ui.

    382 GitHub stars~930 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Write Spec

What does Write Spec do?

Write a full feature spec for a feature. An agent skill from AlexPEClub/ai-coding-starter-kit. Write Spec is an agent skill from AlexPEClub/ai-coding-starter-kit. Write a full feature spec for a feature.

When should I use Write Spec?

Write Spec fits situations like: tasks that involve PRD writing.

How do I install Write Spec in Claude Code?

Run `npx skills add AlexPEClub/ai-coding-starter-kit --skill write-spec -a claude-code`. Or copy the skill folder (.claude/skills/write-spec in AlexPEClub/ai-coding-starter-kit) into .claude/skills/write-spec in your project. Claude Code loads it when a task matches its description.

How do I install Write Spec in Codex?

Run `npx skills add AlexPEClub/ai-coding-starter-kit --skill write-spec -a codex`. Or copy the skill folder (.claude/skills/write-spec in AlexPEClub/ai-coding-starter-kit) into .agents/skills/write-spec in your project. Codex loads it when a task matches its description.

Can I use Write Spec 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 AlexPEClub/ai-coding-starter-kit --skill write-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/write-spec, .gemini/skills/write-spec, .github/skills/write-spec and .opencode/skills/write-spec in your project.

What does Write Spec need to run?

Going by SKILL.md and its folder, Write Spec needs the command-line tools its instructions call (git).

Does Write Spec access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Write Spec 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 Write Spec use?

No licence was found for Write Spec or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Write Spec use?

About 1.9k tokens (SKILL.md is roughly 7.5k 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 Write Spec?

Skills that share tags, products or a category with Write Spec: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars) and Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Write Spec?

AlexPEClub (a GitHub user) maintains it in AlexPEClub/ai-coding-starter-kit, which has 382 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on June 3, 2026.

Source: AlexPEClub/ai-coding-starter-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.