Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 1 addition & 4 deletions SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,10 +41,7 @@ For each command .md, read the frontmatter `description` field. The filename (wi
Scan all installed skills and commands, then present:

1. **Summary** -- How many skills, how many commands, grouped by category
2. **Category map** -- Group skills by purpose. Use a visual flow to show the recommended order:
```
[Phase 1] --> [Phase 2] --> [Phase 3] --> [Phase 4]
```
2. **Category map** -- Dynamically group skills by their actual purpose (security, development, finance, writing, etc.). Do NOT assume all skills belong to the same domain. Only show workflow arrows within a category if the skills have a natural sequential order. Always prefix each item with `[SKILL]` or `[CMD]`.
3. **Complete reference table** -- Each command with a one-line plain-language description
4. **"Where do I start?"** -- Based on the types of skills installed, suggest a concrete first step

Expand Down
54 changes: 49 additions & 5 deletions commands/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,16 +83,60 @@ Present a complete guide with these sections:
- Y slash commands available (type `/command` to use)

**B) Skills vs Commands -- What's the difference?**
Explain in one paragraph: Skills load automatically when Claude detects relevant context. Slash commands need you to type `/command-name` to activate. Users don't need to do anything to "turn on" skills.
Explain clearly with a visual comparison box:

```
+-------------------------------+-------------------------------+
| SKILLS (背景知識) | COMMANDS (動作指令) |
| Auto-loaded, no action needed | You type /command to trigger |
+-------------------------------+-------------------------------+
| Like a textbook on your desk | Like a tool you pick up |
| Claude reads it when relevant | You decide when to use it |
| You do NOTHING to activate | You MUST type the command |
+-------------------------------+-------------------------------+
```

Then list them separately:

**Your Skills (auto-loaded):**
List each skill with a marker like `[SKILL]` prefix and one-line description.

**Your Commands (type to use):**
List each command with the actual `/command` syntax and one-line description.

This separation is critical -- many users don't understand the difference. Make it visually impossible to confuse.

**C) Category Map**
Group all skills and commands by purpose. Show a visual workflow:

IMPORTANT: Do NOT use a hardcoded workflow like "recon → hunt → validate → report". The user may have skills from completely different domains (security, accounting, design, DevOps, etc.).

Instead, dynamically categorize based on what is actually installed:

1. Read the name and description of every scanned skill and command
2. Group them into natural categories based on their actual purpose (e.g., "Security / Bug Bounty", "Finance / Accounting", "Development Tools", "Writing / Documentation", etc.)
3. If skills within a category have a natural workflow order, show it with arrows
4. If they don't have a sequential relationship, just list them as a group

For each category, use this format for EVERY item:
- `[SKILL] skill-name` — description (auto-loaded, you do nothing)
- `[CMD] /command-name` — description (you type this to trigger)

Never list a skill or command without its `[SKILL]` or `[CMD]` prefix.

Example with mixed domains:
```
[Phase 1: Preparation] --> [Phase 2: Execution] --> [Phase 3: Validation] --> [Phase 4: Output]
```
## Security / Bug Bounty
[Preparation] → [Recon] → [Hunting] → [Validation] → [Reporting]
...items...

## Accounting
[CMD] /invoice-scan — ...
[SKILL] tax-rules — ...

Under each phase, list relevant skills and commands with one-line descriptions.
## Development Tools
[CMD] /lint — ...
[SKILL] code-review — ...
```

**D) Complete Command Reference**
A table with columns: Command | What it does | When to use it | Example
Expand Down
Loading