general-skill-maker

# General Skill Maker

Create effective agent skills through guided briefing process that explores requirements, patterns, and best practices.

## Workflow

6-step process: Brief → Load References → Plan Structure → Generate → Apply Best Practices → Present

### Step 1: Briefing Questions

Ask user questions **ONE AT A TIME** (not all at once). Adapt based on answers.

**Complete question library:** See [references/briefing-questions.md](references/briefing-questions.md)

**Core Questions (REQUIRED):**
1. **Skill Purpose** - "Jaki jest główny cel tego skilla?"
2. **Usage Examples** - "Podaj 2-3 przykłady jak użytkownik będzie prosił o użycie tego skilla?"
3. **Environment/Platform** - "Gdzie będzie używany ten skill?"
4. **Freedom Level** - "Jak deterministyczny ma być proces?"
5. **Expected Output** - "Jaki jest oczekiwany output?"

**Optional Questions (ask based on context):**
6. Task Scope - Single vs related tasks
7. User Base - Solo vs team
8. Scripts Needed - For repetitive operations
9. Reference Documentation - API docs, schemas, examples
10. Assets/Templates - Templates, boilerplate code
11. External Integrations - APIs, databases, tools
12. Workflow Type - Multi-step vs single-step
13. User Interaction - Interactive vs autonomous
14. Quality Standards - Validation requirements

**Briefing strategy:**
- Start with core questions (1-5)
- Ask optional questions (6-14) only when relevant based on previous answers
- Adapt and skip irrelevant questions
- See references/briefing-questions.md for detailed questions, follow-ups, and examples

### Step 2: Load Appropriate References

Based on user's answers, read relevant reference files:

**Always read:**
- `references/best-practices.md` - Universal principles for all skills

**Read based on workflow type:**
- `references/workflow-patterns.md` - If multi-step workflow with sequential logic
- `references/integration-patterns.md` - If external API/tool integrations
- `references/tool-based-patterns.md` - If specific