New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Project Stage Detect

by pixel-cellar in pixel-cellar/Claude-Code-Game-Studios

“自动分析项目状态、检测开发阶段、识别缺失项，并根据现有工件推荐后续步骤。”

— description from SKILL.md by pixel-cellar
MITAuto-check: notesDevelopment

Install Project Stage Detect

skills CLI
$ npx skills add pixel-cellar/Claude-Code-Game-Studios --skill project-stage-detect -a claude-code

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

GitHub CLI
$ gh skill install pixel-cellar/Claude-Code-Game-Studios project-stage-detect --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/pixel-cellar/Claude-Code-Game-Studios.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/project-stage-detect .claude/skills/project-stage-detect && 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-stage-detect
GitHub stars
342
Token cost
~816 tokens
SKILL.md length
190 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 6 steps: 扫描关键目录 → 分类项目阶段 → 协作式缺失项识别 → …
  • SKILL.md covers 工作流, 用法示例, 后续行动 and 协作协议
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Project Stage Detect is a skill in pixel-cellar/Claude-Code-Game-Studios (342 stars). Its SKILL.md is about 816 tokens. Licence: MIT.

Requirements

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

Workflow steps

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

  1. 扫描关键目录
  2. 分类项目阶段
  3. 协作式缺失项识别
  4. 生成阶段报告
  5. 角色过滤的推荐（可选）
  6. 写入前请求批准

What it can do on your machine

Read from SKILL.md and the folder at commit 2c016ef. 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
    • Glob
    • Grep
    • Bash

    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 and bash).

    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 Stage Detect loads about 816 tokens when it runs. Until then it costs about 14 tokens; SKILL.md has 190 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Glob, Grep, Bash

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 pixel-cellar/Claude-Code-Game-Studios at commit 2c016ef, republished under its MIT licence (© pixel-cellar). 190 words, ~816 tokens.

Download SKILL.mdSave it as .claude/skills/project-stage-detect/SKILL.md (or your agent's skills folder).
name
project-stage-detect
description
自动分析项目状态、检测开发阶段、识别缺失项，并根据现有工件推荐后续步骤。
allowed-tools
Read, Glob, Grep, Bash
argument-hint
[可选: 角色过滤器，如 'programmer' 或 'designer']
user-invocable
true

项目阶段检测

本技能扫描你的项目以确定其当前开发阶段、工件的完整性以及需要关注的缺失项。特别适用于以下场景：

  • 接手一个现有项目
  • 入职一个代码库
  • 里程碑前检查缺失项
  • 了解 "我们现在在哪里？"

工作流

1. 扫描关键目录

分析项目结构和内容：

设计文档（design/）：

  • 统计 design/gdd/*.md 中的 GDD 文件数
  • 检查 game-concept.md、game-pillars.md、systems-index.md
  • 如果 systems-index.md 存在，统计总系统数与已设计系统数
  • 分析完整性（概述、详细设计、边缘情况等）
  • 统计 design/narrative/ 中的叙事文档数
  • 统计 design/levels/ 中的关卡设计数

源代码（src/）：

  • 统计源文件数（与语言无关）
  • 识别主要系统（包含 5 个以上文件的目录）
  • 检查 core/、gameplay/、ai/、networking/、ui/ 目录
  • 估算代码行数（大致规模）

生产工件（production/）：

  • 检查是否有活跃的 Sprint 计划
  • 查找里程碑定义
  • 查找路线图文档

原型（prototypes/）：

  • 统计原型目录数
  • 检查是否有 README（已文档化 vs 未文档化）
  • 评估原型是已归档还是活跃的

架构文档（docs/architecture/）：

  • 统计 ADR (Architecture Decision Record，架构决策记录) 数量
  • 检查是否有概述/索引文档

测试（tests/）：

  • 统计测试文件数
  • 估算测试覆盖率（粗略启发式）
2. 分类项目阶段

根据扫描的工件确定阶段。先检查 production/stage.txt — 如果存在，使用其值（来自 /gate-check 的显式覆盖）。否则， 使用以下启发式规则自动检测（从最高阶段向前检查）：

阶段指标
概念无游戏概念文档，处于头脑风暴阶段
系统设计游戏概念存在，系统索引缺失或不完整
技术搭建系统索引存在，引擎未配置
预制作引擎已配置，src/ 不到 10 个源文件
制作src/ 有 10 个以上源文件，活跃开发中
打磨仅限显式设置（由 /gate-check 制作 -> 打磨关卡设置）
发布仅限显式设置（由 /gate-check 打磨 -> 发布关卡设置）
3. 协作式缺失项识别

不要只是列出缺失的文件。而是提出澄清问题：

  • "我看到战斗代码（src/gameplay/combat/）但没有 design/gdd/combat-system.md。这是先做的原型，还是应该进行逆向文档化？"
  • "你有 15 个 ADR 但没有架构概述。需要我创建一个来帮助新贡献者吗？"
  • "production/ 中没有 Sprint 计划。你在其他地方跟踪工作吗（Jira、Trello 等）？"
  • "我发现有游戏概念但没有系统索引。你是否已经将概念拆解为各个独立系统，还是需要我运行 /map-systems？"
  • "原型目录有 3 个项目没有 README。这些是实验，还是需要文档化？"
4. 生成阶段报告

使用模板：.claude/docs/templates/project-stage-report.md

报告结构：

markdown
# 项目阶段分析

**日期**：[日期]
**阶段**：[概念/系统设计/技术搭建/预制作/制作/打磨/发布]

## 完整性概览
- 设计：[X%]（[N] 个文档，[缺失项]）
- 代码：[X%]（[N] 个文件，[系统]）
- 架构：[X%]（[N] 个 ADR，[缺失项]）
- 生产管理：[X%]（[状态]）
- 测试：[X%]（[覆盖率估算]）

## 识别的缺失项
1. [缺失项描述 + 澄清问题]
2. [缺失项描述 + 澄清问题]

## 推荐后续步骤
[根据阶段和角色按优先级排列的列表]
5. 角色过滤的推荐（可选）

如果用户提供了角色参数（例如 /project-stage-detect programmer）：

程序员：

  • 专注于架构文档、测试覆盖率、缺失的 ADR
  • 代码与文档的差距

设计师：

  • 专注于 GDD 完整性、缺失的设计章节
  • 原型文档化

制作人：

  • 专注于 Sprint 计划、里程碑追踪、路线图
  • 跨团队协调文档

通用（无角色）：

  • 所有缺失项的全景视图
  • 各领域最高优先级的项目
6. 写入前请求批准

协作协议：

我已经分析了你的项目。以下是我的发现：

[展示摘要]

识别的缺失项：
1. [缺失项 1 + 问题]
2. [缺失项 2 + 问题]

推荐后续步骤：
- [优先级 1]
- [优先级 2]
- [优先级 3]

可以将完整的阶段分析写入 production/project-stage-report.md 吗？

等待用户批准后再创建文件。

用法示例

bash
# 通用项目分析
/project-stage-detect

# 程序员视角分析
/project-stage-detect programmer

# 设计师视角分析
/project-stage-detect designer

后续行动

生成报告后，建议相关的后续步骤：

  • 有概念但没有系统索引？ -> /map-systems 拆解为系统
  • 缺失设计文档？ -> /reverse-document design src/[系统]
  • 缺失架构文档？ -> /architecture-decision 或 /reverse-document architecture
  • 原型需要文档化？ -> /reverse-document concept prototypes/[名称]
  • 没有 Sprint 计划？ -> /sprint-plan
  • 接近里程碑？ -> /milestone-review

协作协议

本技能遵循协作设计原则：

  1. 先提问：对缺失项提问，不要假设
  2. 提供选项："需要我创建 X，还是在其他地方跟踪了？"
  3. 用户决定：等待指示
  4. 展示草稿：显示报告摘要
  5. 获取批准："可以写入 production/project-stage-report.md 吗？"

绝不要静默写入文件。始终先展示发现并询问再创建工件。

© pixel-cellar, 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 .claude/skills/project-stage-detect of pixel-cellar/Claude-Code-Game-Studios.

Open the folder on GitHubat commit 2c016ef

Compare with similar skills

Project Stage Detect 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 Stage Detect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Stage Detect this skillpixel-cellar/Claude-Code-Game-Studios342—~816Automated safety check: NotesMIT
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Vercel Composition Patterns

    supabase/supabase

    Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed

  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from pixel-cellar/Claude-Code-Game-Studios

All 23 skills in this repo

  • Patch Notes

    pixel-cellar/Claude-Code-Game-Studios

    从 git 历史记录、Sprint 数据和内部更新日志生成面向玩家的补丁说明。将开发者语言转化为清晰、有吸引力的玩家沟通内容。

    342 GitHub stars~498 tokensUpdated 6 mo ago
    Auto-check: notes

  • Setup Engine

    pixel-cellar/Claude-Code-Game-Studios

    配置项目的游戏引擎和版本。将引擎锁定到 CLAUDE.md 中，检测知识缺口，当版本超出 LLM 训练数据时通过 WebSearch 填充引擎参考文档。

    342 GitHub stars~1.5k tokensUpdated 6 mo ago
    Auto-check passed

  • Estimate

    pixel-cellar/Claude-Code-Game-Studios

    通过分析复杂度、依赖关系、历史速度和风险因素来估算任务工作量。生成包含置信水平的结构化估算. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~751 tokensUpdated 6 mo ago
    Auto-check passed

  • Perf Profile

    pixel-cellar/Claude-Code-Game-Studios

    结构化的性能分析工作流。识别瓶颈、与性能预算对比测量，并生成带有优先级排序的优化建议. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~466 tokensUpdated 6 mo ago
    Auto-check: notes

  • Release Checklist

    pixel-cellar/Claude-Code-Game-Studios

    生成全面的发布前验证清单，涵盖构建验证、合规要求、商店元数据和发布准备就绪情况. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~696 tokensUpdated 6 mo ago
    Auto-check passed

  • Retrospective

    pixel-cellar/Claude-Code-Game-Studios

    通过分析已完成的工作、速率、阻碍因素和模式来生成 Sprint 或里程碑回顾。产出可执行的洞见以指导下一次迭代. An agent skill from pixel-cellar/Claude-Code-Game-Studios.

    342 GitHub stars~767 tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Project Stage Detect

How do I install Project Stage Detect in Claude Code?

Run `npx skills add pixel-cellar/Claude-Code-Game-Studios --skill project-stage-detect -a claude-code`. Or copy the skill folder (.claude/skills/project-stage-detect in pixel-cellar/Claude-Code-Game-Studios) into .claude/skills/project-stage-detect in your project. Claude Code loads it when a task matches its description.

How do I install Project Stage Detect in Codex?

Run `npx skills add pixel-cellar/Claude-Code-Game-Studios --skill project-stage-detect -a codex`. Or copy the skill folder (.claude/skills/project-stage-detect in pixel-cellar/Claude-Code-Game-Studios) into .agents/skills/project-stage-detect in your project. Codex loads it when a task matches its description.

Can I use Project Stage Detect 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 pixel-cellar/Claude-Code-Game-Studios --skill project-stage-detect -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-stage-detect, .gemini/skills/project-stage-detect, .github/skills/project-stage-detect and .opencode/skills/project-stage-detect in your project.

What does Project Stage Detect need to run?

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

Does Project Stage Detect 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 Stage Detect safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Project Stage Detect use?

Project Stage Detect 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 Stage Detect use?

About 816 tokens (SKILL.md is roughly 3.3k 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 Stage Detect?

Skills that share tags, products or a category with Project Stage Detect: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Stage Detect?

pixel-cellar (a GitHub organization) maintains it in pixel-cellar/Claude-Code-Game-Studios, which has 342 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on March 30, 2026.

Source: pixel-cellar/Claude-Code-Game-Studios on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.