skill-name/
├── SKILL.md        # 核心說明文件，必要
├── scripts/        # 可執行腳本，選用
├── references/     # 參考文件或知識資料，選用
├── assets/         # 圖片、範本、範例檔案等資源，選用

npx skills add https://github.com/anthropics/skills --skill skill-creator

claude install anthropics/skills/skill-creator

/skill-creator

我想建立一個 Skill，用來把會議逐字稿整理成結構化會議紀要。

我想建立一個 Skill，用來分析 WordPress 網站錯誤訊息，並提供排查步驟。

---
name: meeting-minutes
description: Convert meeting transcripts into structured meeting minutes with decisions and action items.
---

# Meeting Minutes Skill

Use this skill when the user provides a meeting transcript and wants a structured meeting summary.

## Output Format

Include the following sections:

1. Meeting topic
2. Date and time
3. Participants
4. Key discussion points
5. Decisions
6. Action items with owner and deadline

## Guidelines

- Keep the summary concise.
- Preserve important decisions.
- Do not invent missing attendees or dates.
- If information is missing, mark it as "未提供".

meeting-minutes/
├── SKILL.md
├── references/
│   └── meeting-template.md
├── assets/
│   └── company-style-guide.pdf

測試一：正常格式的會議逐字稿
測試二：缺少參與人資訊的會議紀錄
測試三：內容很長、決議很多的會議
測試四：只有零散重點，沒有完整逐字稿

description: 幫我整理資料

description: Use this skill when the user provides meeting transcripts and wants structured meeting minutes with decisions, discussion points, and action items.

## Output Format

Return the result in Markdown with the following sections:

# 會議紀要
## 一、會議基本資訊
## 二、討論重點
## 三、決議事項
## 四、待辦事項

## Accuracy Rules

- Do not invent missing information.
- If a field is not provided, write "未提供".
- Preserve names, dates, numbers, and deadlines exactly as given.

## Examples

Good:
- Clear action item with owner and deadline.
- Concise summary without unnecessary commentary.

Bad:
- Inventing a deadline that was not mentioned.
- Mixing discussion points with final decisions.

npx skills add https://github.com/anthropics/skills --skill skill-creator

claude install anthropics/skills/skill-creator

/skill-creator

git clone https://github.com/anthropics/skills.git

https://github.com/anthropics/skills/archive/refs/heads/main.zip

SKILL.md
references/
scripts/
assets/
examples/

1. 任務說明：這個 Skill 是做什麼的
2. 觸發條件：什麼情況下應該使用
3. 操作流程：執行任務時要照什麼步驟
4. 輸出格式：最後要產生什麼格式
5. 工具資源：是否需要腳本、範本、參考文件或 API

my-skill/
├── SKILL.md
├── README.md
├── references/
│   └── knowledge-base.md
├── examples/
│   ├── input-1.md
│   └── output-1.md
├── scripts/
│   └── helper.py
├── assets/
│   └── template.md
└── manifest.json

{
  "name": "wordpress-seo-writer",
  "version": "1.0.0",
  "description": "Generate Traditional Chinese WordPress blog posts with SEO title, tags, meta description, and structured article format.",
  "language": "zh-TW",
  "entry": "SKILL.md",
  "references": [
    "references/seo-guidelines.md"
  ],
  "examples": [
    "examples/input-1.md",
    "examples/output-1.md"
  ],
  "tools": [
    {
      "name": "keyword_checker",
      "type": "script",
      "path": "scripts/keyword_checker.py"
    }
  ]
}

hermes-agent/
├── agents/
│   └── writer-agent/
│       ├── system.md
│       ├── tools.json
│       └── skills/
│           └── wordpress-seo-writer/
│               ├── SKILL.md
│               ├── manifest.json
│               ├── references/
│               ├── examples/
│               └── scripts/

1. 根據使用者輸入，判斷是否需要啟用某個 Skill
2. 讀取該 Skill 的 SKILL.md 與 references/
3. 將 Skill 內容合併進 Agent 的 system prompt 或 task prompt

請幫我寫一篇 WordPress SEO 文章，主題是 skill-creator。

skills/wordpress-seo-writer/SKILL.md
skills/wordpress-seo-writer/references/seo-guidelines.md
skills/wordpress-seo-writer/examples/output-1.md

User Request
     ↓
Intent Router
     ↓
Skill Matcher
     ↓
Load SKILL.md
     ↓
Load references / examples / scripts
     ↓
Compose Agent Prompt
     ↓
Run Model
     ↓
Return Result

{
  "skills": [
    {
      "name": "wordpress-seo-writer",
      "description": "Write Traditional Chinese WordPress SEO articles.",
      "path": "./skills/wordpress-seo-writer",
      "trigger_keywords": [
        "WordPress",
        "SEO文章",
        "部落格文章",
        "中繼描述",
        "標籤"
      ]
    },
    {
      "name": "code-review-security",
      "description": "Review code for security, maintainability, and deployment risks.",
      "path": "./skills/code-review-security",
      "trigger_keywords": [
        "code review",
        "安全檢查",
        "漏洞",
        "重構"
      ]
    }
  ]
}

1. 專案層級規則：放進 AGENTS.md
2. 任務型 Skill：保留成獨立 Skill 資料夾

# AGENTS.md

## Project Rules

- Use Traditional Chinese when writing user-facing documentation.
- Do not modify database schema unless explicitly requested.
- Before changing code, inspect the existing architecture.
- Prefer small, reviewable changes.
- When writing WordPress articles, use the wordpress-seo-writer skill.

project/
├── AGENTS.md
├── skills/
│   └── wordpress-seo-writer/
│       ├── SKILL.md
│       ├── references/
│       ├── examples/
│       └── scripts/

# Code Review Security Skill

Use this skill when reviewing code changes for security, maintainability, and deployment risks.

## Review Checklist

1. Authentication and authorization
2. Input validation
3. SQL injection risk
4. Secrets and environment variables
5. File upload handling
6. Error handling
7. Logging and privacy
8. Deployment risk

## Output Format

Return the review in this format:

# Code Review Report

## Summary
## Critical Issues
## Medium Issues
## Low Risk Suggestions
## Recommended Patch
## Test Plan

## Skills

When the task involves security review, load:

skills/code-review-security/SKILL.md

幫我處理文章

當使用者要求撰寫 WordPress SEO 部落格文章，且需要標題、標籤、中繼描述與繁體中文內容時，使用此 Skill。

1. 先用 Skill description 判斷要不要使用
2. 再根據任務讀取必要 references
3. 只載入與當前任務相關的段落

python scripts/check.py

python /app/skills/wordpress-seo-writer/scripts/check.py

1. SKILL.md 不要寫死特定平台專用語法
2. 把平台相關設定放到 adapters/ 目錄
3. 把核心流程寫在 core.md
4. 把範例輸入輸出放到 examples/
5. 把工具設定放到 manifest.json

portable-skill/
├── core.md
├── SKILL.md
├── manifest.json
├── adapters/
│   ├── claude-code.md
│   ├── hermes-agent.md
│   └── codex-agents.md
├── references/
├── examples/
└── scripts/

□ Skill 的用途是否明確？
□ description 是否能讓 Agent 判斷何時使用？
□ 輸入格式是否定義清楚？
□ 輸出格式是否固定？
□ 是否有 examples？
□ 是否有 references？
□ references 是否可以被目標系統讀取？
□ scripts 是否能在目標環境執行？
□ 是否需要 API key 或環境變數？
□ 是否有測試案例？
□ 是否有平台專用 adapter？
□ 是否避免把敏感資訊寫進 Skill？