Agent skill

Project Skill Creator

by Philip-Cao-9527 in Philip-Cao-9527/code-note-helper

基于用户需求和项目真实上下文创建或更新项目本地 skill。用于把高频协作流程、领域任务、项目规范、prompt 生成流程或审查流程沉淀为可复用 skill,并避免把一次性任务误做成长期 skill。

MITAuto-check passedAgent Workflows

Install Project Skill Creator

skills CLI
$ npx skills add Philip-Cao-9527/code-note-helper --skill project-skill-creator -a claude-code

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

GitHub CLI
$ gh skill install Philip-Cao-9527/code-note-helper project-skill-creator --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/Philip-Cao-9527/code-note-helper.git skills-src && mkdir -p .claude/skills && cp -r skills-src/vibe-coding-template/skills/project-skill-creator .claude/skills/project-skill-creator && 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-skill-creator
GitHub stars
273
Token cost
~820 tokens
SKILL.md length
219 words
Files
3 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

基于用户需求和项目真实上下文创建或更新项目本地 skill。用于把高频协作流程、领域任务、项目规范、prompt 生成流程或审查流程沉淀为可复用 skill,并避免把一次性任务误做成长期 skill。

  • Works in 5 steps: 明确用户想沉淀的流程 → 读取目标项目的 AGENTS.md 或同类规则文件,以及与该流程直接相关的项目材料。 → 读取… → …
  • Tasks that involve Skill authoring
  • SKILL.md covers 技能定位, 什么时候应该创建新 skill, 与其他规则资产的边界 and 讲解类 skill 的硬校验, plus 5 more sections
  • Calls python

What it does

Project Skill Creator is an agent skill from Philip-Cao-9527/code-note-helper. 基于用户需求和项目真实上下文创建或更新项目本地 skill。用于把高频协作流程、领域任务、项目规范、prompt 生成流程或审查流程沉淀为可复用 skill,并避免把一次性任务误做成长期 skill。

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/skill-template.md`).

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: 一个专为算法刷题、深度学习和 AI 学习场景打造的浏览器扩展。拒绝机械的复制粘贴,帮你自动化生成高质量复盘笔记、内置遗忘曲线驱动的间隔复习、轻松驾驭超长对话,让刷过的每一道题都成为真正的技术资产!. The licence is MIT.

When your agent uses it

  • Tasks that involve Skill authoring

Example prompts

  • “/project-skill-creator”

Requirements

  • Python 3

Workflow steps

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

  1. 明确用户想沉淀的流程
  2. 读取目标项目的 AGENTS.md 或同类规则文件,以及与该流程直接相关的项目材料。
  3. 读取 references/skill-template.md,按目标流程生成或更新 skill。
  4. 为新 skill 选择不会与系统 skill、插件 skill 或已有项目 skill 冲突的名称。
  5. 只创建必要文件

What it can do on your machine

Read from SKILL.md and the folder at commit 7421249. 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:

    • python

    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 Skill Creator loads about 820 tokens when it runs, and up to ~2.6k if it reads all its reference files. Until then it costs about 31 tokens; SKILL.md has 219 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~31
When it runs · the whole SKILL.md, loaded when a task matches
~820
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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

The full file from Philip-Cao-9527/code-note-helper at commit 7421249, republished under its MIT licence (© Philip-Cao-9527). 219 words, ~820 tokens.

Download SKILL.mdSave it as .claude/skills/project-skill-creator/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
project-skill-creator
description
基于用户需求和项目真实上下文创建或更新项目本地 skill。用于把高频协作流程、领域任务、项目规范、prompt 生成流程或审查流程沉淀为可复用 skill,并避免把一次性任务误做成长期 skill。

project-skill-creator

技能定位

创建或更新项目本地 skill。它面向“后续会反复出现、输入输出稳定、边界清晰”的流程,不用于一次性任务总结,也不替代具体业务实现。

这个 skill 负责 skill 结构、触发条件、必读材料、模板引用、质量标准和验证方式。它不应该把项目全部规范粗暴塞进单个 skill,也不应该把一次性 prompt 包装成长期能力。

什么时候应该创建新 skill

适合创建新 skill 的情况:

  • 某类任务会反复出现,并且每次都需要相似的读取顺序、边界判断和输出格式。
  • 任务有清晰触发词、适用场景和不适用场景。
  • 任务需要引用专属模板、固定检查清单、示例输出或脚本。
  • 任务与项目规则相关,但比 AGENTS.md 更具体、更偏流程。
  • 用户明确希望把流程沉淀为后续可调用的本地 skill。

不适合创建新 skill 的情况:

  • 只有一次性需求,用普通 prompt 更合适。
  • 需求还没稳定,关键输入、输出和边界都在变化。
  • 只是几条项目长期规则,应写进 AGENTS.md。
  • 只是一次开发、修复或文档任务,应交给 $project-prompt-creator。
  • 只是先计划后执行,应交给 $plan-mode-planner。
  • 只是 code review,应交给 $code-reviewer。
  • 想把所有规范都塞进一个万能 skill,导致职责混乱。

与其他规则资产的边界

  • AGENTS.md:放长期、全项目生效的底线规则,如语言、编码、测试、版本、报告、错误处理和不可做事项。
  • $project-prompt-creator:生成一次具体任务的执行 prompt,不沉淀长期流程。
  • $plan-mode-planner:生成要求 Plan mode 先决策后执行的 prompt。
  • $code-reviewer:生成审查任务 prompt,不承担通用开发任务。
  • $web-search:提供通用联网检索、外部依据分层和最新事实核对;创建检索类 skill 时可参考它的触发规则、来源优先级和输出结构。
  • $knowledge-explainer:提供通用技术原理、八股讲解、从零教学和项目追问回答;创建领域讲解类 skill 时可参考它的强质量门槛、双层讲解结构和未实现能力边界。
  • 新 skill:承载某个高频流程的专属读取顺序、模板、输出格式和验证要求。

讲解类 skill 的硬校验

创建或改写技术原理、八股讲解、从零教学、面试口述、项目追问类 skill 时,必须先读取 $knowledge-explainer 源模板,再生成目标 skill。

不得削弱 $knowledge-explainer 的最高约束、1000 / 3000 字硬门槛、未达字数视为输出失败、输出结构、质量门槛、自检项和“未实现不能说成已实现”的边界。确实需要裁剪时,必须逐条说明裁剪原因、影响范围和后续补偿方式。

生成后必须运行讲解类专项校验脚本:

powershell
python -X utf8 vibe-coding-template/skills/knowledge-explainer/scripts/validate_knowledge_explainer.py path/to/knowledge-explainer/SKILL.md

如果脚本失败,必须继续修改目标 SKILL.md 并复跑,直到通过。该脚本只校验结构和关键质量规则是否保留,不判断最终讲解内容是否真的写得好。

使用流程

  1. 明确用户想沉淀的流程:
    • 谁会使用。
    • 什么时候触发。
    • 不适用于什么场景。
    • 需要读取哪些项目材料。
    • 输入信息是什么。
    • 最终产物是什么。
    • 哪些边界必须禁止。
  2. 读取目标项目的 AGENTS.md 或同类规则文件,以及与该流程直接相关的项目材料。
  3. 读取 references/skill-template.md,按目标流程生成或更新 skill。
  4. 为新 skill 选择不会与系统 skill、插件 skill 或已有项目 skill 冲突的名称。
  5. 只创建必要文件:
    • SKILL.md 必须有。
    • agents/openai.yaml 仅在项目使用该元数据入口时创建。
    • references/ 仅在需要专属模板、较长检查清单或示例输出时创建。
    • scripts/ 仅在需要可复用自动化脚本时创建。
    • templates/ 仅在需要复制型文件模板时创建。
    • assets/ 仅在需要图片、示例数据、静态资源时创建。
    • 不创建空目录、空模板或未来可能用得上的占位文件。

命名要求

  • 使用小写字母、数字和连字符。
  • 不使用 skill-creator 这类容易和系统 skill 冲突的名称。
  • 名称应表达动作和对象,例如 project-prompt-creator、code-reviewer。
  • 如果项目已有命名风格,优先沿用项目风格。

输出要求

  • 生成完整 skill 文件内容或补丁方案。
  • SKILL.md frontmatter 必须包含 name 和 description。
  • description 要写清用途、触发场景和边界,不写空泛口号。
  • SKILL.md 必须说明何时读取 references/、何时运行 scripts/、何时使用 templates/ 或 assets/。
  • 如果 SKILL.md、模板或生成出的 prompt 需要交叉引用其他 skill,必须使用 $skill-name 形式;不要只写反引号包裹的 skill 名称。
  • 如果创建 agents/openai.yaml,只写必要 UI 字段并保证 YAML 可解析。

验证要求

创建或更新 skill 后,至少验证:

  • SKILL.md frontmatter 可解析,字段必要且不重复。
  • skill 名称符合命名要求。
  • agents/openai.yaml 可解析。
  • references/、scripts/、templates/、assets/ 中被引用的文件真实存在。
  • 所有新增或修改的中文 Markdown / YAML 文件 UTF-8 可读。
  • 没有保留英文占位说明、空标题、项目私有硬编码或一次性任务残留。

自检

输出前逐条检查:

  1. 这个流程是否真的值得沉淀成 skill,而不是一次性 prompt。
  2. 新 skill 是否职责单一、触发清楚、边界明确。
  3. 是否没有把多个无关行为模式堆进一个 skill。
  4. 是否没有复制旧项目私有路径、模块名、版本号、测试命令或发布规则。
  5. 如果交叉引用其他 skill,是否统一使用 $skill-name 形式。
  6. 是否避免和系统 skill、插件 skill 或项目已有 skill 撞名。
  7. 是否设计了可执行的结构校验、YAML 校验和 UTF-8 读取校验。

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

Files

SKILL.md and 2 other files (references) in vibe-coding-template/skills/project-skill-creator of Philip-Cao-9527/code-note-helper.

  • SKILL.md
  • agents/openai.yaml
  • references/skill-template.md

Open the folder on GitHubat commit 7421249

Compare with similar skills

Project Skill Creator 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 Skill Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Skill Creator this skillPhilip-Cao-9527/code-note-helper273—~820Automated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    67k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Philip-Cao-9527/code-note-helper

All 13 skills in this repo
  • Agents Md Creator

    Philip-Cao-9527/code-note-helper

    基于项目真实背景、用户长期偏好和现有文档生成或更新项目级 AGENTS.md。用于新项目初始化、迁移协作规则、整理语言编码测试版本文档约束、沉淀长期协作底线和交付格式时使用。

    273 GitHub stars~581 tokensUpdated 2 mo ago
    Auto-check passed
  • Codenote Fix Prompt

    Philip-Cao-9527/code-note-helper

    为 CodeNote Helper 生成普通开发、修复、验证、治理、文档和审核友好类中文执行 prompt。用于把一次具体任务整理成可直接交给 Codex 或 Agent 执行的 prompt;不承载 Plan mode prompt、code review prompt 或项目 skill creator 的完整职责。

    273 GitHub stars~931 tokensUpdated 2 mo ago
    Auto-check passed
  • Codenote Skill Creator

    Philip-Cao-9527/code-note-helper

    创建或更新 CodeNote Helper 项目本地 .agents/skills 下的 Codex skills。用于把高频协作流程、prompt 生成流程、审查流程或项目专项流程沉淀为可复用 skill;不替代一次性任务 prompt、普通开发实现或万能规则汇总。

    273 GitHub stars~948 tokensUpdated 2 mo ago
    Auto-check passed
  • Project Prompt Creator

    Philip-Cao-9527/code-note-helper

    在项目 AGENTS.md 约束下生成可直接交给 Codex 或 Agent 执行的中文任务 prompt。用于开发、修复、文档、验证、审计、治理或交接任务的 prompt 化,但不承载 Plan mode 和 code review 的完整模式规则。

    273 GitHub stars~693 tokensUpdated 2 mo ago
    Auto-check passed
  • Knowledge Explainer

    Philip-Cao-9527/code-note-helper

    当用户要求技术原理讲解、八股讲解、从零教学、面试口述、项目追问回答、领域补课、把项目实现转成可复习表达,或在缺少领域背景时需要先理解概念再推进项目时使用;覆盖后端、前端、数据库、分布式、系统设计、编译构建、DevOps、安全、产品业务、数据分析、Agent、LLM、科研方法等可迁移领域。若涉及最新论文、官方文档、benchmark、争议结论或现代 API,先调用 $web-search。

    273 GitHub stars~899 tokensUpdated 2 mo ago
    Auto-check passed
  • Code Reviewer

    Philip-Cao-9527/code-note-helper

    生成面向 code review 任务的中文 prompt。用于审查代码、文档、配置、PR diff、指定 commit 或发布前风险;默认只生成审查任务 prompt,不直接 review,也不直接修改代码。

    273 GitHub stars~599 tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Project Skill Creator

What does Project Skill Creator do?

基于用户需求和项目真实上下文创建或更新项目本地 skill。用于把高频协作流程、领域任务、项目规范、prompt 生成流程或审查流程沉淀为可复用 skill,并避免把一次性任务误做成长期 skill。. Project Skill Creator is an agent skill from Philip-Cao-9527/code-note-helper.

When should I use Project Skill Creator?

Project Skill Creator fits situations like: tasks that involve Skill authoring.

How do I install Project Skill Creator in Claude Code?

Run `npx skills add Philip-Cao-9527/code-note-helper --skill project-skill-creator -a claude-code`. Or copy the skill folder (vibe-coding-template/skills/project-skill-creator in Philip-Cao-9527/code-note-helper) into .claude/skills/project-skill-creator in your project. Claude Code loads it when a task matches its description.

How do I install Project Skill Creator in Codex?

Run `npx skills add Philip-Cao-9527/code-note-helper --skill project-skill-creator -a codex`. Or copy the skill folder (vibe-coding-template/skills/project-skill-creator in Philip-Cao-9527/code-note-helper) into .agents/skills/project-skill-creator in your project. Codex loads it when a task matches its description.

Can I use Project Skill Creator 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 Philip-Cao-9527/code-note-helper --skill project-skill-creator -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-skill-creator, .gemini/skills/project-skill-creator, .github/skills/project-skill-creator and .opencode/skills/project-skill-creator in your project.

What does Project Skill Creator need to run?

Going by SKILL.md and its folder, Project Skill Creator needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Project Skill Creator 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 Skill Creator 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 Skill Creator use?

Project Skill Creator 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 Skill Creator use?

About 820 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. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Project Skill Creator?

Skills that share tags, products or a category with Project Skill Creator: Skill Creator (Azure/azqr, 796 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Skill Creator?

Philip-Cao-9527 (a GitHub user) maintains it in Philip-Cao-9527/code-note-helper, which has 273 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on July 15, 2026.

Source: Philip-Cao-9527/code-note-helper on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.