Skip to content
Skills Library
AI & agents · Learning & explanation

example-skill

/example-skill

Example skill demonstrating the Skills-as-Containers pattern with workflows, assets, and natural language routing. This is a teaching tool showing the complete PAI v1.2.0 architecture. USE WHEN user says 'show me an example', 'demonstrate the pattern', 'how do skills work', 'example skill

Author
zmre ↗
Repository
nix-pai ↗
Licence
MIT
Last repository change
23.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Example skill demonstrating the Skills-as-Containers pattern with workflows, assets, and natural language routing. This is a teaching tool showing the complete PAI v1.2.0 architecture. USE WHEN user says 'show me an example', 'demonstrate the pattern', 'how do skills work', 'example skill

Triggers from the description

show me an exampledemonstrate the patternhow do skills work
Original author description

Example skill demonstrating the Skills-as-Containers pattern with workflows, assets, and natural language routing. This is a teaching tool showing the complete PAI v1.2.0 architecture. USE WHEN user says 'show me an example', 'demonstrate the pattern', 'how do skills work', 'example skill

How it works

  1. Architecture Overview
  2. Included Workflows
  3. Routing Logic
  4. Assets
  5. Usage Examples
  6. Creating Your Own Skill
  7. Best Practices
  8. Technical Details
  9. Documentation
  10. References
Original SKILL.md headings · 184 lines, 677 words
SKILL.md preview
---
name: example-skill
description: |
  Example skill demonstrating the Skills-as-Containers pattern with workflows,
  assets, and natural language routing. This is a teaching tool showing the
  complete PAI v1.2.0 architecture.

  USE WHEN user says 'show me an example', 'demonstrate the pattern',
  'how do skills work', 'example skill'
---

# Example Skill

**Purpose:** This skill exists to demonstrate the Skills-as-Containers pattern introduced in PAI v1.2.0. Use it as a template for creating your own skills.

## Architecture Overview

Skills in PAI v1.2.0 are organized as self-contained containers with:

### Core Components
- **SKILL.md** - Core skill definition with routing logic (you're reading it now!)
- **workflows/** - Specific task workflows for discrete operations
- **assets/** - Templates, references, and helper files

### Progressive Disclosure
1. **Metadata** (always loaded) - Name, description, triggers
2. **Instructions** (loaded when triggered) - This SKILL.md content
3. **Resources** (loaded as needed) - Individual workflow and asset files

## Included Workflows

This skill includes three example workflows demonstrating different complexity levels:

### 1. simple-task.md
**Purpose:** Basic single-step workflow
**Trigger:** User says "simple example", "basic task"
**Demonstrates:** Minimal workflow structure

### 2. complex-task.md
**Purpose:** Multi-step workflow with dependencies
**Trigger:** User says "complex example", "multi-step task"
**Demonstrates:** Structured workflow with validation

### 3. parallel-task.md
**Purpose:** Agent orchestration for parallel execution
**Trigger:** User says "parallel example", "parallel task"
**Demonstrates:** Multi-agent coordination pattern

## Routing Logic

Natural language automatically routes to the right workflow:

```
User Intent → Skill Activation → Workflow Selection → Execution

Example Flow:
"Show me a simple example"
    ↓ (matches trigger)
example-skill loads
    ↓ (analyzes intent: "simple")
simple-task.md selected
    ↓
Workflow executes
```

## Assets

This skill includes example assets in the `assets/` directory:
- `template.md` - Example template file
- `reference.md` - Example reference material

These demonstrate how to organize supporting resources.

## Usage Examples

### Basic Usage
```
User: "Show me a simple example"
→ Loads example-skill
→ Executes simple-task.md workflow
→ Returns basic workflow demonstration
```

### Complex Usage
```
User: "I need a complex multi-step example"
→ Loads example-skill
→ Executes complex-task.md workflow
→ Returns structured multi-step demonstration
```

### Parallel Usage
```
User: "How do I parallelize work?"
→ Loads example-skill
→ Executes parallel-task.md workflow
→ Returns agent orchestration demonstration
```

## Creating Your Own Skill

Use this skill as a template:

1. **Copy the structure:**
   ```bash
   cp -r skills/example-skill ~/.claude/skills/your-skill-name
   ```

2. **Update SKILL.md:**
   - Change name and description in frontmatter
   - Update trigger phrases
   - Replace example content with your skill's purpose

3. **Create workflows:**
   - Add workflow files in workflows/ directory
   - Each workflow = one specific task
   - Name workflows descriptively

4. **Add assets (optional):**
   - Templates, references, helper scripts
   - Keep organized in assets/ directory

5. **Test activation:**
   - Test trigger phrases
   - Verify workflow routing
   - Ensure natural language works

## Best Practices

### Skill Organization
- ✅ One skill per domain/topic area
- ✅ Multiple workflows within a skill
- ✅ Clear trigger phrases
- ❌ Don't create skills for one-off tasks
- ❌ Don't duplicate knowledge across skills

### Workflow Design
- ✅ Self-contained with clear steps
- ✅ Focused on ONE specific task
- ✅ Include trigger phrases
- ❌ Don't make workflows too granular
- ❌ Don't duplicate skill context

### Natural Language Routing
- ✅ Use descriptive trigger phrases
- ✅ Test with variations
- ✅ Think like a user
- ❌ Don't require exact phrase matching
- ❌ Don't make users memorize commands

## Technical Details

### File Structure
```
example-skill/
├── SKILL.md              # This file (core definition)
├── workflows/            # Specific task workflows
│   ├── simple-task.md
│   ├── complex-task.md
│   └── parallel-task.md
├── assets/               # Supporting resources
│   ├── template.md
│   └── reference.md
└── README.md             # Overview documentation
```

### Loading Behavior
1. Skill metadata always loaded (YAML frontmatter)
2. SKILL.md body loaded when skill activates
3. Individual workflows loaded when selected
4. Assets loaded when referenced

### Integration Points
- **Natural Language:** Trigger phrases activate skill
- **Other Skills:** Can reference this skill's workflows
- **Agents:** Can invoke specific workflows
- **Commands:** Can route to this skill's workflows

## Documentation

- **Architecture:** See `~/Projects/PAI/docs/ARCHITECTURE.md`
- **Migration Guide:** See `~/Projects/PAI/docs/MIGRATION.md`
- **Skill Development:** See `~/.claude/skills/create-skill/`

## References

- **Anthropic Skills:** https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview
- **PAI Repository:** https://github.com/danielmiessler/Personal_AI_Infrastructure
- **v1.2.0 Changes:** Skills-as-Containers migration completed 2025-10-31

---

**This is a template skill - customize it for your needs!**
Files in this package (7)
  • README.md 4 KB
  • SKILL.md 5 KB
  • assets/reference.md 4 KB
  • assets/template.md 2 KB
  • workflows/complex-task.md 3 KB
  • workflows/parallel-task.md 5 KB
  • workflows/simple-task.md 1 KB

Versions

RepositoryScoreLicence
This page · zmre/nix-pai100MIT
anthropics/claude-plugins-official100Apache-2.0
awakehsh/awesome-agent-tools100MIT
HermeticOrmus/claude-code-guide100MIT
devswha/oh-my-gjc100MIT
sendaifun/skills100Apache-2.0
aegntic/cldcde95MIT

Database snapshot: 13.11.2026 · package version 59fcfd8d30c4 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100pai-skill-transfer
    USE WHEN transferring a PAI skill to a standard Claude Code plugin, porting skills between environments, strip PAI specifics, adapt PAI skill for marketplace, extract skill from PAI. Guides the transformation of PAI-embedded skills into standalone plugin-compatible skills —…
  • 100create-skill
    Guide for creating new skills in @assistantName@'s personal AI infrastructure. Use when user wants to create, update, or structure a new skill that extends capabilities with specialized knowledge, workflows, or tool integrations. Follows both Anthropic skill standards and PAI-specific patterns.
  • 95PAISetup
    Install, upgrade, and configure Daniel Miessler's Personal AI Infrastructure (PAI) memory system with guided identity customization. USE WHEN PAI setup, PAI install, install PAI, setup PAI, upgrade PAI, update PAI, personal AI infrastructure, memory system setup, identity files,…
  • 100setup
    Install, configure and verify PAI Knowledge OS, including workers, the router and the cockpit. USE WHEN user says "set up PAI", "install PAI", "configure PAI", "give Claude a memory", "set up workers", "set up the cockpit", or asks whether their PAI install is healthy.…
  • 95pai
    架构师派活:用 pai-run 把实现任务派给执行方模型(默认 deepseek = Claude Code 外壳经 opencode go 跑 deepseek-v4.1-flash;deepseek-dsh = DeepSeek Harness(dsh)外壳跑同一模型;另有 sonnet;默认模型用 pai-m 切换,模型表在 models.json),在 Otty 当前 tab 右侧分屏可见执行,执行方写结构化回执(成败都写)自动感知完成、画面长时间不动判卡死,架构师亲自重跑 verification 验收。当用户输入 /pai…
  • 95CreateSkill
    Scaffold new PAI skills with proper YAML front matter, TitleCase naming, flat folder structure (SKILL.md + Workflows/ + Tools/), and validation against SkillSystem.md. USE WHEN create skill, new skill, skill structure, canonicalize, validate skill, update skill, fix skill structure, scaffold skill.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.