Agent skill

Spec Start

by HHU3637kr in HHU3637kr/skills

当用户开始新的开发任务、需要启动完整 Spec 流程(需求对齐→探索→设计→实现→测试→收尾),或需要为一个新 Spec 创建协作上下文和 GitHub Flow 工作分支时使用。不要用于已有完成 Spec 的小迭代(用 spec-update)、项目首次初始化(用 spec-init)、运行期故障诊断与 bug 修复(用 spec-debug),或不需要启动 Spec…

No licenceAuto-check passedDevelopment

Install Spec Start

skills CLI
$ npx skills add HHU3637kr/skills --skill spec-start -a claude-code

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

GitHub CLI
$ gh skill install HHU3637kr/skills spec-start --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/HHU3637kr/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/spec-start .claude/skills/spec-start && 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
spec-start
GitHub stars
145
Token cost
~4.6k tokens
SKILL.md length
777 words
Files
1
Skills in repo
37
Repo updated
First seen
Licence
None found

At a glance

当用户开始新的开发任务、需要启动完整 Spec 流程(需求对齐→探索→设计→实现→测试→收尾),或需要为一个新 Spec 创建协作上下文和 GitHub Flow 工作分支时使用。不要用于已有完成 Spec 的小迭代(用 spec-update)、项目首次初始化(用 spec-init)、运行期故障诊断与 bug 修复(用 spec-debug),或不需要启动 Spec…

  • Works in 8 steps: 当前 Agent 即是 TeamLead:调用本 Skill 的 Agent… → 角色定义由 spec-init 持久化:spec-start… → 本次 Spec 创建运行实例:角色线程/实例在当前 Spec… → …
  • Development work in your project
  • SKILL.md covers 核心原则, 前置检查, 角色总览 and 工作流程, plus 4 more sections
  • Calls git, python3 and bash

What it does

Spec Start is an agent skill from HHU3637kr/skills. 当用户开始新的开发任务、需要启动完整 Spec 流程(需求对齐→探索→设计→实现→测试→收尾),或需要为一个新 Spec 创建协作上下文和 GitHub Flow 工作分支时使用。不要用于已有完成 Spec 的小迭代(用 spec-update)、项目首次初始化(用 spec-init)、运行期故障诊断与 bug 修复(用 spec-debug),或不需要启动 Spec 流程的纯文档/记忆写入(用对应 Skill)。

Its SKILL.md is about 4.6k 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 Development. It works with GitHub and Git.

When your agent uses it

  • Development work in your project

Example prompts

  • “/spec-start”

Workflow steps

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

  1. 当前 Agent 即是 TeamLead:调用本 Skill 的 Agent 本身就承担 TeamLead 职责,无需创建额外的 TeamLead 角色
  2. 角色定义由 spec-init 持久化:spec-start 只加载和唤起项目级角色,不内联维护角色 prompt
  3. 本次 Spec 创建运行实例:角色线程/实例在当前 Spec 生命周期内尽量保持可恢复,跨 Spec 状态必须文件化
  4. 角色 vs Skill 区分:角色(spec-writer)是 Who,Skill(spec-write)是 How
  5. TeamLead 统一协调:所有阶段转换、跨角色通信和用户确认节点均由 TeamLead(当前 Agent)主导
  6. 版本感知与归属:每个 Spec 必须隶属于具体 Version(如 v1.6),物理路径创建在 spec/versions//specs//
  7. 需求性质四分平权:在启动时明确需求性质(feat 业务功能 / tech 技术底座 / debt 技术债治理 / fix 缺陷修复),破除技术基建被边缘化的问题
  8. 分支隔离与集成基线:每个 Spec 默认以日常集成线 dev 为基线创建独立工作分支(/spec-),完工后通过 PR/MR 合入 dev。主干(master 或动态读取 origin/HEAD)仅由版本发版(version-release)与热修写入

What it can do on your machine

Read from SKILL.md and the folder at commit a2cccf6. 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
    • python3
    • bash

    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

Spec Start loads about 4.6k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 777 words of instructions outside code blocks.

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

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 777 words (~4,612 tokens).

name
spec-start
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in spec-start of HHU3637kr/skills.

Open the folder on GitHubat commit a2cccf6

Compare with similar skills

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

Spec Start compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spec Start this skillHHU3637kr/skills145—~4.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Pull Request Title and Body Writeropeninterpreter/openinterpreter69k2 repos~1.1kAutomated safety check: PassApache-2.0
Draft Release Notesjamiepine/voicebox57k—~941Automated safety check: PassMIT
PR Review State Fetchprisma/orm48k—~767Automated safety check: PassApache-2.0

Similar skills

  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Pull Request Title and Body Writer

    openinterpreter/openinterpreter

    Rewrites the title and body of one or more pull requests with gh, leading with why the change was made, then what changed, and describing only the net result.

    69k GitHub starsUsed in 2 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Draft Release Notes

    jamiepine/voicebox

    Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.

    57k GitHub stars~941 tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Official

    Fetches a pull request's canonical review state as JSON, validates it, and renders markdown, a text summary and triage target files from it using bundled scripts.

    48k GitHub stars~767 tokensUpdated today
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    70k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from HHU3637kr/skills

All 37 skills in this repo
  • Gif Sticker Maker

    HHU3637kr/skills

    Convert photos (people, pets, objects, logos) into 4 animated GIF stickers with captions.

    145 GitHub starsUsed in 3 repos~1.3k tokens
    Auto-check passed
  • Agent Browser

    HHU3637kr/skills

    Headless browser automation for AI agents using agent-browser CLI.

    145 GitHub stars~1.9k tokensUpdated 16 days ago
    Auto-check passed
  • Darwin Skill

    HHU3637kr/skills

    Darwin Skill (达尔文.skill): autonomous skill optimizer inspired by Karpathy's autoresearch.

    145 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed
  • Token Efficiency

    HHU3637kr/skills

    Cross-platform token audit and optimization for AI coding agents (Cursor, Codex, Claude Code, Hermes, Windsurf, Cline, OpenClaw, Gemini CLI, Aider).

    145 GitHub stars~842 tokensUpdated 16 days ago
    Auto-check passed
  • Guizang Ppt Skill

    HHU3637kr/skills

    生成横向翻页网页 PPT(单 HTML 文件),含 WebGL 背景、章节幕封、数据大字报、图片网格等模板。提供两种风格:① "电子杂志 × 电子墨水"(衬线 + 流体背景 + 暖色) ② "瑞士国际主义"(无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮)。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT,或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss…

    145 GitHub starsUsed in 1 repo~4.7k tokens
    Auto-check passed
  • Huashu Nuwa

    HHU3637kr/skills

    女娲造人:输入人名/主题/甚至只是模糊需求,自动深度调研→思维框架提炼→生成可运行的人物Skill. An agent skill from HHU3637kr/skills.

    145 GitHub starsUsed in 1 repo~4k tokens
    Auto-check passed

Works with

Categories

Questions about Spec Start

What does Spec Start do?

当用户开始新的开发任务、需要启动完整 Spec 流程(需求对齐→探索→设计→实现→测试→收尾),或需要为一个新 Spec 创建协作上下文和 GitHub Flow 工作分支时使用。不要用于已有完成 Spec 的小迭代(用 spec-update)、项目首次初始化(用 spec-init)、运行期故障诊断与 bug 修复(用 spec-debug),或不需要启动 Spec…. Spec Start is an agent skill from HHU3637kr/skills.

When should I use Spec Start?

Spec Start fits situations like: development work in your project.

How do I install Spec Start in Claude Code?

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

How do I install Spec Start in Codex?

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

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

What does Spec Start need to run?

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

Does Spec Start 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 Spec Start 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 Spec Start use?

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

How many tokens does Spec Start use?

About 4.6k tokens (SKILL.md is roughly 18k 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 Spec Start?

Skills that share tags, products or a category with Spec Start: Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars), Create Pull Request (cline/cline, 70k stars), Pull Request Title and Body Writer (openinterpreter/openinterpreter, 69k stars) and Draft Release Notes (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec Start?

HHU3637kr (a GitHub user) maintains it in HHU3637kr/skills, which has 145 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on September 23, 2026.

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