Agent skill

Codenote Skill Creator

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

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

MITAuto-check passedAgent Workflows

Install Codenote Skill Creator

skills CLI
$ npx skills add Philip-Cao-9527/code-note-helper --skill codenote-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 codenote-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/.agents/skills/codenote-skill-creator .claude/skills/codenote-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
codenote-skill-creator
GitHub stars
273
Token cost
~948 tokens
SKILL.md length
285 words
Files
4 (incl. scripts, references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 6 steps: AGENTS.md → 仅当 AGENTS.override.md 存在时读取它。 → DEVLOG.md → …
  • Tasks that involve Skill authoring
  • SKILL.md covers 技能定位, 必读文件, 命名与结构要求 and 讲解类 skill 的硬校验, plus 4 more sections
  • Runs Python scripts from its folder; calls python, rg and git

What it does

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

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

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

  • “/codenote-skill-creator”

Requirements

  • Python 3

Workflow steps

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

  1. AGENTS.md
  2. 仅当 AGENTS.override.md 存在时读取它。
  3. DEVLOG.md
  4. README.md
  5. .agents/skills 当前真实结构。
  6. 与目标流程直接相关的现有 skill、模板、报告或项目文件。

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • rg
    • 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

Codenote Skill Creator loads about 948 tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 285 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~948
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

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); the scripts in this folder 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). 285 words, ~948 tokens.

Download SKILL.mdSave it as .claude/skills/codenote-skill-creator/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
codenote-skill-creator
description
创建或更新 CodeNote Helper 项目本地 `.agents/skills` 下的 Codex skills。用于把高频协作流程、prompt 生成流程、审查流程或项目专项流程沉淀为可复用 skill;不替代一次性任务 prompt、普通开发实现或万能规则汇总。

CodeNote Helper 本地 Skill Creator

技能定位

本 skill 服务于 CodeNote Helper 仓库内 .agents/skills 的创建和更新。它帮助后续把稳定、可复用、有明确输入输出的协作流程沉淀成本地 skill。

适合沉淀为 skill 的流程:

  • 高频出现,读取顺序、边界判断和输出格式相对稳定。
  • 有明确触发场景、不适用场景和最终产物。
  • 需要专属模板、审查清单、prompt 骨架或项目专项流程。
  • 比 AGENTS.md 更具体,比一次性 prompt 更可复用。

不适合创建 skill 的情况:

  • 只有一次性需求,用 $codenote-fix-prompt 生成普通执行 prompt 更合适。
  • 只是先计划后执行,用 $codenote-plan-mode-prompt。
  • 只是生成审查任务 prompt,用 $codenote-code-review-prompt。
  • 只是普通开发实现,不应包装成长期 skill。
  • 想把所有 AGENTS.md 规则粗暴塞进单个万能 skill。

必读文件

触发本 skill 后,先读取:

  1. AGENTS.md
  2. 仅当 AGENTS.override.md 存在时读取它。
  3. DEVLOG.md
  4. README.md
  5. .agents/skills 当前真实结构。
  6. 与目标流程直接相关的现有 skill、模板、报告或项目文件。

不要修改根目录 references/ 的非项目代码;.agents/skills/*/references/ 属于本地 skill 资产,可在确有用途时创建或修改。

命名与结构要求

  • skill 名称使用小写字母、数字和连字符。
  • 名称避免和系统 skill、插件 skill、vibe-coding-template skill 以及 .agents/skills 既有名称撞名。
  • SKILL.md 必须存在,frontmatter 只写必要字段,必须包含 name 和 description。
  • description 必须写清用途、触发场景和边界,不写空泛口号。
  • agents/openai.yaml 只写必要 UI 字段:display_name、short_description、default_prompt。
  • default_prompt 必须明确包含 $skill-name。
  • 如果 SKILL.md、模板或生成出的 prompt 需要交叉引用其他 skill,必须使用 $skill-name 形式;不要只写反引号包裹的 skill 名称。
  • references/ 仅用于较长模板、固定输出骨架、检查清单或示例 prompt。
  • scripts/ 仅用于可重复运行的校验、生成、迁移或格式化脚本;如果创建讲解类 skill,必须复用本 skill 的讲解类专项校验脚本。
  • 不创建空目录、空模板、未来可能用得上的占位文件。

讲解类 skill 的硬校验

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

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

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

powershell
python -X utf8 .agents/skills/codenote-skill-creator/scripts/validate_knowledge_explainer.py .agents/skills/knowledge-explainer/SKILL.md

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

创建或更新流程

  1. 明确目标流程:
    • 谁会使用。
    • 什么时候触发。
    • 不适用于什么场景。
    • 输入信息是什么。
    • 最终产物是什么。
    • 需要读取哪些项目材料。
    • 哪些边界必须禁止。
  2. 核对 .agents/skills 当前结构和目标名称是否冲突。
  3. 读取 references/skill-template.md,按 CodeNote Helper 本地语境裁剪。
  4. 只创建当前需要的文件:
    • SKILL.md
    • 按需创建 references/具体模板.md
    • 按需创建 agents/openai.yaml
  5. 写完后通读所有新增或修改文件,清理占位字段、空标题、一次性任务残留和模板腔废话。
  6. 执行结构、UTF-8、frontmatter、引用存在性、YAML 文本结构和 git 范围检查。

CodeNote Helper 专属边界

创建或更新 skill 时,按需保留这些项目背景:

  • 简体中文输出、Windows 与 UTF-8 编码。
  • 默认保持当前版本;本地 skill 治理通常不修改 manifest.json、popup 版本或 README 版本徽章。
  • 涉及协作资产结构调整时,通常需要 DEVLOG.md 同版本记录和 docs 修复报告;如果生成报告,必须按 CodeNote Helper 语境写清楚 skill / prompt 资产变化对后续任务、版本记录和维护流程的影响,不要只堆路径、英文 skill 名或模板字段。
  • 涉及浏览器扩展运行时代码、权限、远程请求或用户数据时,必须继承 Chrome Web Store 审核友好约束。
  • 禁止无依据保护逻辑和吞异常。
  • 用户可见文案必须自然中文。

不要把这些规则无差别复制进每个新 skill。只保留目标流程需要的最小上下文,并把较长模板放入 references/。

验证要求

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

  • rg --files .agents/skills 核对结构。
  • 所有新增或修改的 Markdown / YAML 文件可用 Get-Content -Encoding UTF8 读取。
  • 每个新增或修改的 SKILL.md 有 name 和 description。
  • skill 名称符合小写字母、数字和连字符规则。
  • SKILL.md 中提到的 references/、agents/openai.yaml 和模板文件真实存在。
  • agents/openai.yaml 文本结构包含必要字段;没有 YAML 解析器时说明使用文本结构校验。
  • 没有残留空标题、英文占位说明、临时任务句、无用目录或未引用文件。
  • 如果创建或改写讲解类 skill,运行 python -X utf8 .agents/skills/codenote-skill-creator/scripts/validate_knowledge_explainer.py .agents/skills/knowledge-explainer/SKILL.md,失败时继续修改并复跑。
  • git status --short 确认没有误改运行时代码、根目录 references/ 或参考模板目录。

自检

输出或交付前检查:

  1. 新 skill 是否职责单一、触发清楚、边界明确。
  2. 是否没有把一次性任务包装成长期 skill。
  3. 是否没有把普通开发、Plan mode、code review 和 skill creator 混成一个万能 skill。
  4. 是否没有复制其他项目的私有路径、版本号、测试命令或发布规则。
  5. 如果交叉引用其他 skill,是否统一使用 $skill-name 形式。
  6. 是否所有引用文件真实存在,并通过 UTF-8 读取和基础结构检查。
  7. 如果目标是讲解类 skill,是否已通过讲解类专项校验脚本。

© 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 3 other files (scripts, references) in .agents/skills/codenote-skill-creator of Philip-Cao-9527/code-note-helper.

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

Open the folder on GitHubat commit 7421249

Compare with similar skills

Codenote 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.

Codenote Skill Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codenote Skill Creator this skillPhilip-Cao-9527/code-note-helper273—~948Automated 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
  • 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
  • Project Skill Creator

    Philip-Cao-9527/code-note-helper

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

    273 GitHub stars~820 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 Codenote Skill Creator

What does Codenote Skill Creator do?

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

When should I use Codenote Skill Creator?

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

How do I install Codenote Skill Creator in Claude Code?

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

How do I install Codenote Skill Creator in Codex?

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

Can I use Codenote 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 codenote-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/codenote-skill-creator, .gemini/skills/codenote-skill-creator, .github/skills/codenote-skill-creator and .opencode/skills/codenote-skill-creator in your project.

What does Codenote Skill Creator need to run?

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

Does Codenote Skill Creator 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 Codenote 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Codenote Skill Creator use?

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

About 948 tokens (SKILL.md is roughly 3.8k 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.1k tokens, read only when the agent opens those files.

What are the alternatives to Codenote Skill Creator?

Skills that share tags, products or a category with Codenote 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 Codenote 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.