Agent skill

Agent Skill Designer

by jerrywu001 in jerrywu001/cc-sessions-viewer

Teaches how to design a good SKILL.md around five patterns: Tool Wrapper, Generator, Reviewer, Inversion and Pipeline.

MITAuto-check passedAgent Workflows

SKILL.md written in Chinese; this summary is our English description.

Install Agent Skill Designer

skills CLI
$ npx skills add jerrywu001/cc-sessions-viewer --skill skill-designer -a claude-code

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

GitHub CLI
$ gh skill install jerrywu001/cc-sessions-viewer skill-designer --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/jerrywu001/cc-sessions-viewer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/skill-designer .claude/skills/skill-designer && 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
skill-designer
GitHub stars
396
Token cost
~1k tokens
SKILL.md length
148 words
Files
8 (incl. references)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Teaches how to design a good SKILL.md around five patterns: Tool Wrapper, Generator, Reviewer, Inversion and Pipeline.

  • Starting a new skill and deciding how to structure its SKILL.md
  • SKILL.md covers 核心概念, 第一步:判断用哪种模式, 第二步:按模式写SKILL.md and 第三步:组合模式, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Reworking a skill that stuffs every rule into one file

What it does

Writing SKILL.md files is already standardized, the guide argues, but designing their content is the hard part, and the same skill performs very differently depending on how it is organized. It offers five patterns: Tool Wrapper, which loads a library's conventions on demand; Generator, which fills fixed templates; Reviewer, which scores against a checklist; Inversion, where the agent interviews you first; and Pipeline, which forces ordered steps with checkpoints.

A short set of questions picks the pattern: does the skill produce a fixed document or code structure, does it need information from the user first, must it run in ordered steps, or does it teach a library. Reviewer is the default. For each pattern the skill gives a structure and key points, such as keeping rules in references/, asking one question at a time and stating a gate like Do NOT start building until the answers are in.

Patterns can be combined, for example Pipeline with a Reviewer self-check or Generator with Inversion to collect variables first. Common mistakes covered are stuffing every rule into SKILL.md, choosing the wrong pattern and omitting gates. Example files exist for each pattern, plus a decision tree and evals. The SKILL.md is in Chinese and triggers when you start creating a new skill.

When your agent uses it

  • Starting a new skill and deciding how to structure its SKILL.md
  • Reworking a skill that stuffs every rule into one file
  • Choosing between a checklist-style reviewer and a step-by-step pipeline

Example prompts

  • “I want to create a skill that reviews database migrations. Which design pattern fits?”
  • “Restructure my release-notes skill as a Generator with a template and a style guide.”
  • “My skill keeps skipping steps. Add gates so the agent cannot continue without my confirmation.”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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

Agent Skill Designer loads about 1k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 16 tokens; SKILL.md has 148 words of instructions outside code blocks.

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

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 jerrywu001/cc-sessions-viewer at commit 5bf4343, republished under its MIT licence (© jerrywu001). 148 words, ~1,023 tokens.

Download SKILL.mdSave it as .claude/skills/skill-designer/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
skill-designer
description
教你怎么设计高质量 SKILL.md 内容的 skill。当用户要创建新 skill 时自动触发。

Agent Skill Designer

一个教你怎么设计高质量SKILL.md内容的skill。当用户要创建新skill时自动触发。

核心概念

SKILL.md的格式已经标准化了,但内容设计才是难点。同样的skill,用不同模式组织,效果天差地别。

5种设计模式:

模式核心作用何时用
Tool Wrapper让AI临时变成某个库的专家传递框架/库的规范和使用惯例
Generator按固定模板生成结构化文档生成固定格式的输出物
Reviewer按检查清单评分/审查评审、审计、打分
InversionAI先问你,再决定怎么做需求不明确、需要引导
Pipeline强制按步骤执行,有检查点复杂任务、不能跳过步骤

第一步:判断用哪种模式

回答3个问题,快速定位:

Q1: 这个skill是要产生一个固定的文档/代码结构吗?

  • 是 → Generator
  • 否 ↓

Q2: 这个skill需要先收集用户信息才能工作吗?

  • 是 → Inversion
  • 否 ↓

Q3: 这个skill需要分步骤执行、不能跳过吗?

  • 是 → Pipeline
  • 否 ↓

Q4: 这个skill是让AI"学习"某个库的用法吗?

  • 是 → Tool Wrapper
  • 否 ↓

兜底: Reviewer(默认模式)

第二步:按模式写SKILL.md

Pattern 1: Tool Wrapper

适用场景:让AI在遇到特定技术栈时,自动加载最佳实践

核心结构:

markdown
## 核心规范
读取 'references/conventions.md' 获取完整规范

## 写作时
1. 加载规范文件
2. 严格遵守每一条规则
3. 为所有函数签名添加类型注解

## 审查时
1. 加载规范文件
2. 对照检查每一条
3. 对每个违规,引用具体规则并给出修复建议

关键点:

  • 规范文件独立存放(references/)
  • 只在真正需要时才加载(渐进式披露)
  • 规则要具体、可执行
Pattern 2: Generator

适用场景:生成结构一致的文件(报告、文档、代码模板)

核心结构:

markdown
## 工作流程

Step 1: 加载样式指南
读取 'references/style-guide.md'

Step 2: 加载输出模板
读取 'assets/output-template.md'

Step 3: 询问缺失信息
向用户收集模板中缺失的变量:
- 主题是什么?
- 关键数据点?
- 目标读者?

Step 4: 填充模板
严格按照样式指南的规则填充每个section

Step 5: 输出
返回完整的Markdown文档

关键点:

  • 模板和样式指南独立(assets/ + references/)
  • 必须向用户收集缺失变量
  • 输出格式固定,不可自定义
Pattern 3: Reviewer

适用场景:代码审查、质量审计、安全检查

核心结构:

markdown
## 审查协议

Step 1: 加载检查清单
读取 'references/review-checklist.md'

Step 2: 理解代码
先读懂代码的目的,再开始批评

Step 3: 逐项检查
对每个违规项:
- 记录位置(行号或大概位置)
- 分类 severity:error / warning / info
- 解释为什么是问题
- 给出具体修复代码

Step 4: 输出结构化报告
- Summary:代码做什么、总体评价
- Findings:按 severity 分组
- Score:1-10分,简短理由
- Top 3 Recommendations:最有价值的改进

关键点:

  • 检查清单独立(可替换)
  • 按 severity 分组输出
  • 每个问题要解释"为什么"而不只是"是什么"
Pattern 4: Inversion

适用场景:需求不明确、需要AI引导用户思考

核心结构:

markdown
## 采访式交互

你是主持人。**不要**在收集完所有信息前开始构建。

### Phase 1 — 问题发现(一次问一个,等回答)

Q1: 这个项目为用户解决什么问题?
Q2: 主要用户是谁?技术水平如何?
Q3: 预期规模?(日活、数据量、请求量)

### Phase 2 — 技术约束(仅在Phase 1完成后再问)

Q4: 部署环境是什么?
Q5: 技术栈有什么偏好或限制?
Q6: 有什么硬性要求?(延迟、可用性、合规、预算)

### Phase 3 — 整合(仅在所有问题回答后才执行)

1. 加载输出格式模板
2. 用收集的信息填充每个section
3. 呈现完整方案
4. 询问:"这个方案准确吗?有什么要改的?"
5. 根据反馈迭代,直到用户确认

关键点:

  • 必须显式声明"Do NOT start building until..."
  • 严格按phase顺序,一次只问一个问题
  • 所有问题回答完才能进入合成阶段
Pattern 5: Pipeline

适用场景:复杂任务,必须按顺序执行、中间有检查点

核心结构:

markdown
## 执行流程(不可跳过步骤)

### Step 1 — 解析 & 盘点
分析代码,提取所有公开的类、函数、常量
列出清单,询问:"这是你想文档化的完整API吗?"

### Step 2 — 生成文档字符串(Gate: 必须用户确认后才能进入Step 3)
对每个缺少文档的函数:
- 加载 'references/docstring-style.md'
- 按规范生成文档字符串
- 展示给用户审批

### Step 3 — 组装文档
加载 'assets/api-doc-template.md'
将所有类、函数、文档字符串编译成完整API参考文档

### Step 4 — 质量检查
对照 'references/quality-checklist.md' 检查:
- 每个公开符号都有文档
- 每个参数都有类型和描述
- 每个函数至少一个使用示例
修复问题后再呈现最终文档

关键点:

  • 显式的Gate条件(如"必须用户确认后才能进入Step 3")
  • 每步失败则整个pipeline停止
  • 可以在Pipeline里嵌套Reviewer(自检)

第三步:组合模式

这些模式不是互斥的,可以组合:

组合方式适用场景
Pipeline + ReviewerPipeline末尾加自检步骤
Generator + Inversion先收集变量,再填充模板
Tool Wrapper + Reviewer学习规范后进行审查

快速参考

我想要...              → 用什么模式
─────────────────────────────────────
让AI学习某框架规范    → Tool Wrapper
生成固定格式的文档    → Generator
代码审查/质量审计     → Reviewer
先问需求再行动        → Inversion
强制按步骤执行        → Pipeline

常见错误

错误1: 把所有规则直接塞进SKILL.md

markdown
# ❌ 错误 - 规则太多,AI记不住
## 规则1: xxx
## 规则2: xxx
## 规则3: xxx
...(50条规则)
markdown
# ✅ 正确 - 外部引用,按需加载
## 规则
读取 'references/coding-conventions.md' 获取完整规则列表

错误2: 模式选择错误

  • 需要生成结构化文档,却用了Reviewer
  • 需要引导需求,却直接开始写代码

错误3: 缺少Gate条件

  • Pipeline没有检查点,AI跳步
  • Inversion没有"Do NOT start"声明,AI直接开始构建

参考资源

详细示例和ADK代码参考:

  • references/tool-wrapper-example.md - FastAPI专家skill示例
  • references/generator-example.md - 技术报告生成器示例
  • references/reviewer-example.md - 代码审查员示例
  • references/inversion-example.md - 项目规划师示例
  • references/pipeline-example.md - 文档流水线示例
  • references/decision-tree.md - 模式选择决策树

© jerrywu001, 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 7 other files (references) in .agents/skills/skill-designer of jerrywu001/cc-sessions-viewer.

  • SKILL.md
  • evals/evals.json
  • references/decision-tree.md
  • references/generator-example.md
  • references/inversion-example.md
  • references/pipeline-example.md
  • references/reviewer-example.md
  • references/tool-wrapper-example.md

Open the folder on GitHubat commit 5bf4343

Compare with similar skills

Agent Skill Designer 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.

Agent Skill Designer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agent Skill Designer this skilljerrywu001/cc-sessions-viewer396—~1kAutomated 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.

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

More from jerrywu001/cc-sessions-viewer

  • Guarded Git Commit and Push

    jerrywu001/cc-sessions-viewer

    Commits and pushes only on an explicit request, pulling first, running the project's CI checks locally, and stopping cold on any conflict or failure.

    396 GitHub stars~603 tokensUpdated 3 days ago
    Auto-check: notes
  • Tauri Dev MCP Bridge

    jerrywu001/cc-sessions-viewer

    Launches a Tauri app's dev build with the MCP bridge compiled in, so an agent can take screenshots, read the live DOM, click real buttons and call real backend commands.

    396 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check: warnings

Categories

Questions about Agent Skill Designer

What does Agent Skill Designer do?

Teaches how to design a good SKILL.md around five patterns: Tool Wrapper, Generator, Reviewer, Inversion and Pipeline. md files is already standardized, the guide argues, but designing their content is the hard part, and the same skill performs very differently depending on how it is organized. It offers five patterns: Tool Wrapper, which loads a library's conventions on demand; Generator, which fills fixed templates; Reviewer, which scores against a checklist; Inversion, where the agent interviews you first; and Pipeline, which forces ordered steps with checkpoints.

When should I use Agent Skill Designer?

Agent Skill Designer fits situations like: starting a new skill and deciding how to structure its SKILL.md; reworking a skill that stuffs every rule into one file; choosing between a checklist-style reviewer and a step-by-step pipeline.

How do I install Agent Skill Designer in Claude Code?

Run `npx skills add jerrywu001/cc-sessions-viewer --skill skill-designer -a claude-code`. Or copy the skill folder (.agents/skills/skill-designer in jerrywu001/cc-sessions-viewer) into .claude/skills/skill-designer in your project. Claude Code loads it when a task matches its description.

How do I install Agent Skill Designer in Codex?

Run `npx skills add jerrywu001/cc-sessions-viewer --skill skill-designer -a codex`. Or copy the skill folder (.agents/skills/skill-designer in jerrywu001/cc-sessions-viewer) into .agents/skills/skill-designer in your project. Codex loads it when a task matches its description.

Can I use Agent Skill Designer 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 jerrywu001/cc-sessions-viewer --skill skill-designer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-designer, .gemini/skills/skill-designer, .github/skills/skill-designer and .opencode/skills/skill-designer in your project.

What does Agent Skill Designer need to run?

SKILL.md names no scripts, command-line tools or credentials: Agent Skill Designer is instructions for the agent only.

Does Agent Skill Designer 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 Agent Skill Designer 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 Agent Skill Designer use?

Agent Skill Designer 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 Agent Skill Designer use?

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

What are the alternatives to Agent Skill Designer?

Skills that share tags, products or a category with Agent Skill Designer: 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 Agent Skill Designer?

jerrywu001 (a GitHub user) maintains it in jerrywu001/cc-sessions-viewer, which has 396 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 7, 2026.

Source: jerrywu001/cc-sessions-viewer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.