Skill Creator (ThepExcel Edition)

Based on Anthropic’s official skill-creator (Apache 2.0). Enhanced with ThepExcel deployment workflow and enhancement pipeline.

Quick Start

Core Principles

Concise is Key

Context window เป็นทรัพยากรที่แชร์กัน — ทุกบรรทัดต้องจ่ายค่า token

Claude ฉลาดอยู่แล้ว → ใส่เฉพาะสิ่งที่ Claude ไม่รู้:

• “Claude ต้องการคำอธิบายนี้จริงไหม?”
• “ย่อหน้านี้คุ้มค่า token ไหม?”

Degrees of Freedom

Test with All Models

Skill Structure

skill-name/
├── SKILL.md (required)     ← < 500 lines
│   ├── YAML frontmatter    ← name + description only
│   └── Markdown body       ← loaded when triggered
├── scripts/                ← deterministic code
├── references/             ← loaded as needed (one level deep)
└── assets/                 ← templates, not loaded into context

Frontmatter Rules

Description Best Practices

# Good: what + when + triggers
description: Extract text and tables from PDF files, fill forms, merge documents.
  Use when working with PDF files or when the user mentions PDFs or document extraction.

# Bad: first person, vague
description: I can help you with PDFs.

“When to Use” in body = useless — Claude only sees description when deciding to trigger.

Naming Conventions

Bundled Resources

ห้ามสร้าง: README.md, CHANGELOG.md, INSTALLATION_GUIDE.md — skills สำหรับ AI ไม่ใช่คน

Progressive Disclosure

Details: See progressive-disclosure.md

Creation Process

Overview

1. Understand → 2. Plan → 3. Init → 4. Edit → 5. Package → 6. Deploy → 7. Iterate

Step 1: Understand

ถามผู้ใช้:

• “Skill นี้ต้องรองรับ functionality อะไรบ้าง?”
• “ยกตัวอย่าง 2-3 scenarios ที่จะใช้”
• “ผู้ใช้จะพูดอะไรที่ควร trigger skill นี้?”

Tip: ใช้ /extract-expertise สำหรับ domain ที่ซับซ้อน

Step 2: Plan

วิเคราะห์แต่ละ example:

Step 3: Initialize

scripts/init_skill.py <skill-name> --path <output-directory>

Step 4: Edit

Order: resources first → test scripts → update SKILL.md last

Design pattern references:

• workflows.md — Sequential, conditional, loops
• output-patterns.md — Templates, formatting
• anti-patterns.md — Common mistakes

Step 5: Package & Validate

scripts/package_skill.py <path/to/skill-folder>
scripts/quick_validate.py <path/to/skill-folder>

Step 6: Deploy (ThepExcel)

┌─ Skill ใหม่
│   ├─ Public? (ใครก็ใช้ได้)  → /mnt/d/agent-skills/[skill-name]/
│   └─ Private? (เฉพาะพี่ระ)  → /mnt/d/claude-private/skills/[skill-name]/
│
├─ Symlink ไป global
│   └─ ln -s /mnt/d/[repo]/[skill-name] ~/.claude/skills/[skill-name]
│
├─ Update registry
│   └─ เพิ่มใน /mnt/d/claude-master/CLAUDE.md → Skills Inventory
│
└─ Commit & Push
    └─ git add → commit → push (ทั้ง skill repo + claude-master)

Step 7: Iterate

1. ใช้ skill กับงานจริง
2. สังเกตจุดที่ติดขัด
3. ปรับปรุง (ใช้ Enhancement Mode)

See evaluation.md for Claude A/B testing pattern.

Content Guidelines

Avoid Time-Sensitive Information

# Bad
If you're doing this before August 2025, use the old API.

# Good
## Current method
Use the v2 API endpoint.

Use Consistent Terminology

เลือกคำเดียว ใช้ตลอดทั้ง skill:

Quality Checklist

Core

• Description: what + when, third person, specific triggers
• SKILL.md body < 500 lines
• No time-sensitive info, consistent terminology
• Concrete examples (not abstract)
• References one level deep

Code

• Scripts handle errors, no magic constants
• Required packages listed
• Forward slashes (no Windows paths)

Testing

• Tested with real usage scenarios
• Tested with target models

Enhancement Mode

ใช้เมื่อ ปรับปรุง skill เดิม

Route Decision

Full Enhancement Pipeline

1. AUDIT → 2. RESEARCH → 3. INTEGRATE → 4. OPTIMIZE → 5. VALIDATE

Step 1: AUDIT

อ่าน target skill → score ด้วย audit rubric:

Present ผลแบบนี้:

SKILL: [name]
SCORES: Coverage [?] | Depth [?] | Structure [?] | Actionability [?] | Examples [?]
TOTAL: [?]/25 → [Draft/Working/Solid/Production]

จุดที่ควรปรับ:
1. [ปัญหา + ผลกระทบ]
2. [ปัญหา + ผลกระทบ]

→ ถามผู้ใช้ก่อน: “ปรับทั้งหมด หรือเลือกเฉพาะข้อ?”

Step 2: RESEARCH

ใช้ /deep-research หรือ /extract-expertise เพื่อเติม knowledge gaps

Step 3: INTEGRATE

Classify findings → prioritize by impact → merge ด้วย integration patterns

Step 4: OPTIMIZE

Apply skill-creator standards: progressive disclosure, conciseness, references/

Step 5: VALIDATE

Before/after comparison:

| Dimension | Before | After | เปลี่ยนอะไร |
|-----------|--------|-------|------------|

→ Log ใน enhancement-log.md

Enhancement Rules

• Research BEFORE writing — อย่าเดา domain knowledge
• Preserve what works — enhance ไม่ใช่ rewrite
• Show evidence — link findings to changes

Example: boost-intel Enhancement

BEFORE: 17/25 (Solid) — Examples 2/5, Actionability 3/5
CHANGES:
  1. +Quick Mode (30-sec sanity check)
  2. +Facilitation Guide (how Claude walks through phases)
  3. Move CAPTURE → reference (reduce bloat)
  4. +Concrete example (WordPress vs CMS — full loop)
  5. Expand REFLECT (deeper questions + pattern recognition)
AFTER: 23/25 (Production) — all dimensions ≥ 4

Facilitation Guide

Create Mode

1. ถาม: "อยากสร้าง skill อะไรคะ? ช่วยยกตัวอย่าง 2-3 scenarios"
2. วิเคราะห์: public หรือ private? simple หรือ complex?
3. ถ้า complex → ใช้ /extract-expertise ก่อน
4. Init → Edit → Test → Package → Deploy
5. สรุป: "Skill [name] สร้างเสร็จแล้วค่ะ อยู่ที่ [path]"

Enhance Mode

1. อ่าน SKILL.md + references ทั้งหมด
2. Audit → present ผลเป็นตาราง
3. ถาม: "ปรับทั้งหมด หรือเลือกข้อ?"
4. ทำตามที่ user เลือก
5. Before/after comparison → commit

Key Behaviors

• ถามก่อนทำ — ไม่ rewrite โดยไม่ถาม
• Show scores — ผู้ใช้ต้องเห็นว่าอะไรดี อะไรไม่ดี
• ทำทีละ step — ไม่ dump ทุกอย่างทีเดียว

References

Related Skills

• /extract-expertise — Extract expert knowledge to inform skill content
• /deep-research — Research domain before building or enhancing skill
• /optimize-prompt — Optimize skill descriptions and system prompts