Agent skill

Spec Init

by HHU3637kr in HHU3637kr/skills

当项目首次接入 Spec 驱动开发 / R&K Flow,需要创建 AGENTS.md、.agents/rules/、 .agents/skills/、spec/ 目录、记忆系统和 HTML 报告资产时使用。

No licenceAuto-check passedAgent Workflows

Install Spec Init

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

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

GitHub CLI
$ gh skill install HHU3637kr/skills spec-init --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-init .claude/skills/spec-init && 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-init
GitHub stars
145
Token cost
~5.1k tokens
SKILL.md length
733 words
Files
2 (incl. references)
Skills in repo
37
Repo updated
First seen
Licence
None found

At a glance

当项目首次接入 Spec 驱动开发 / R&K Flow,需要创建 AGENTS.md、.agents/rules/、 .agents/skills/、spec/ 目录、记忆系统和 HTML 报告资产时使用。

  • Works in 4 steps: 幂等性:所有操作先检查后创建,已存在则跳过,不覆盖已有内容 → 完整性:一次搭建完整的项目骨架,用户无需手动补充 → 一次性:整个项目生命周期只需执行一次,后续开发任务使用 spec-start → …
  • Tasks that involve Agent instruction files
  • SKILL.md covers 核心原则, 工作流程, 初始化后的目录结构 and 后续动作
  • Calls git, bash and npm

What it does

Spec Init is an agent skill from HHU3637kr/skills. 当项目首次接入 Spec 驱动开发 / R&K Flow,需要创建 AGENTS.md、.agents/rules/、 .agents/skills/、spec/ 目录、记忆系统和 HTML 报告资产时使用。 典型信号:用户说"初始化项目"/"搭建 Spec 环境"/"创建开发环境",或项目根目录缺少 AGENTS.md / spec/。 不要用于已有项目的单个 Spec 开发、功能更新或少量规范修改。

Its SKILL.md is about 5.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/project-agent-roles.md`).

It sits in Agent Workflows, covering Agent instruction files. It works with Git.

When your agent uses it

  • Tasks that involve Agent instruction files

Example prompts

  • “搭建 Spec 环境”
  • “创建开发环境”
  • “/spec-init”

Workflow steps

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

  1. 幂等性:所有操作先检查后创建,已存在则跳过,不覆盖已有内容
  2. 完整性:一次搭建完整的项目骨架,用户无需手动补充
  3. 一次性:整个项目生命周期只需执行一次,后续开发任务使用 spec-start
  4. 脚本化优选:提供全自动化一键初始化脚本(scripts/init-ai-workflow.sh 与 scripts/init-ai-workflow.ps1),在无交互或新项目初始化场景下可直接一键执行。

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
    • bash
    • npm
    • python

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

  • Network

    No URLs in SKILL.md. Its commands use git and npm, 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 Init loads about 5.1k tokens when it runs, and up to ~8.9k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 733 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~53
When it runs · the whole SKILL.md, loaded when a task matches
~5.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.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 733 words (~5,140 tokens).

“如果 AGENTS.md 和 spec/ 都已存在,告知用户无需重复初始化,建议直接使用 spec-start 启动开发任务。 如果完全未初始化,Agent 可优先通过一键脚本完成底层物理目录与角色挂载,再执行后续基本信息补齐。”

— opening of SKILL.md by HHU3637kr
name
spec-init
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in spec-init of HHU3637kr/skills.

  • SKILL.md
  • references/project-agent-roles.md

Open the folder on GitHubat commit a2cccf6

Compare with similar skills

Spec Init 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 Init compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spec Init this skillHHU3637kr/skills145—~5.1kAutomated safety check: PassNone
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Harness Evolution Feedback Looprevfactory/harness9.1k—~855Automated safety check: PassApache-2.0
Setup Matt Pocock Skillsywwynm/EverythingDone1449 repos~1.7kAutomated safety check: PassGPL-3.0
Squad Agent Collaboration Patternsmicrosoft/waza1.4k4 repos~500Automated safety check: PassMIT
Docslatitude-dev/latitude-llm4.7k—~2.5kAutomated safety check: PassMIT

Similar skills

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Collects feedback on how an agent harness performed, generalizes it, and updates the harness agents, skills and orchestrator along with a change-history table.

    9.1k GitHub stars~855 tokensUpdated 10 days ago
    Agent WorkflowsAuto-check passed
  • Setup Matt Pocock Skills

    ywwynm/EverythingDone

    Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…

    144 GitHub starsUsed in 9 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • Official

    Shared collaboration rules for a team of squad agents covering worktree awareness, writing decisions to an inbox, cross-agent requests and reviewer lockout.

    1.4k GitHub starsUsed in 4 repos~500 tokens
    Agent WorkflowsAuto-check passed
  • Docs

    latitude-dev/latitude-llm

    Review the current conversation context and git changes, then persist durable repository knowledge into dev-docs/.md by domain and into AGENTS.md for cross-cutting repo rules.

    4.7k GitHub stars~2.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Reconcile Context

    Apocrathia/home-assistant-config

    Fix drift in Home Assistant Homelab agent context (AGENTS.md, CLAUDE.md, .agents/context/, rules, skills, agents) against the repo.

    179 GitHub stars~931 tokensUpdated 16 days ago
    Agent WorkflowsAuto-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 4 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 15 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 15 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 Init

What does Spec Init do?

当项目首次接入 Spec 驱动开发 / R&K Flow,需要创建 AGENTS.md、.agents/rules/、 .agents/skills/、spec/ 目录、记忆系统和 HTML 报告资产时使用。. Spec Init is an agent skill from HHU3637kr/skills.

When should I use Spec Init?

Spec Init fits situations like: tasks that involve Agent instruction files.

How do I install Spec Init in Claude Code?

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

How do I install Spec Init in Codex?

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

Can I use Spec Init 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-init -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-init, .gemini/skills/spec-init, .github/skills/spec-init and .opencode/skills/spec-init in your project.

What does Spec Init need to run?

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

Does Spec Init access the network?

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

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

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

How many tokens does Spec Init use?

About 5.1k tokens (SKILL.md is roughly 21k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.

What are the alternatives to Spec Init?

Skills that share tags, products or a category with Spec Init: Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Harness Evolution Feedback Loop (revfactory/harness, 9.1k stars), Setup Matt Pocock Skills (ywwynm/EverythingDone, 144 stars) and Squad Agent Collaboration Patterns (microsoft/waza, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spec Init?

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.