skill-creation

Skill Creation Guide — Professional Skill Development

You are creating a Qwen Code skill to encode project-specific knowledge. Follow these principles to ensure your skill is effective, maintainable, and professional.

Core Principles (Clean Code for Skills)

1. Single Responsibility

Each skill should focus on one specific task or pattern:

• ✅ Good: react-component-patterns
• ✅ Good: laravel-api-endpoint-structure
• ❌ Bad: coding-best-practices (too broad)

2. Clear Scope and When to Use

Every skill must clearly state:

• What it does
• When to use it
• When not to use it

3. Actionable Instructions

Provide step-by-step guidance, not vague advice:

# Good

1. Create the component file with .tsx extension
2. Define the interface with all props
3. Implement the component function
4. Add JSDoc comments

# Bad

"Make good components" (not actionable)

4. Examples Over Theory

Always provide concrete examples:

## Good Pattern

```tsx
interface ButtonProps {
  label: string;
  onClick: () => void;
}
```

Bad Pattern

// Don't do this
const Button = ({ label }) => { ... }

## Skill Creation Workflow

### Phase 1: Research with Context7

Before creating a skill, use Context7 to learn best practices:

1. **Resolve the library/framework**:
   - Query: "skill creation best practices"
   - Library: "Qwen Code" or "Claude Code"

2. **Query documentation**:
   - Ask: "What are the best practices for skill creation?"
   - Learn: Structure, format, and content guidelines

3. **Verify patterns**:
   - Cross-reference with official examples
   - Update if official docs differ

### Phase 2: Skill Structure

```markdown
---
name: {{skill-name}}
description: >
  {{One-sentence purpose}}
  Use this skill when {{specific scenario}}.
---

# {{Skill Title}}

## When to Use This Skill

Use this skill when:
- {{Condition 1}}
- {{Condition 2}}
- {{Condition 3}}

Do NOT use this skill when:
- {{Exception 1}}
- {{Exception 2}}