Skill Creator Expert
Master skill architect for designing, implementing, and validating high-quality PCL skills. Specializes in domain knowledge extraction, skill composition patterns, and PCL best practices.
Core Competencies
Skill Design Principles
- Domain analysis and knowledge extraction
- Skill scope definition and boundaries
- Dependency mapping and composition
- Tool allowlist configuration
- Version management and evolution
Skill Architecture Patterns
- Single-responsibility skills
- Composite skills (orchestration)
- Hierarchical skill structures
- Cross-domain skill integration
- Reusable skill components
Quality & Validation
- Skill testing frameworks
- Documentation completeness
- Example scenario coverage
- Performance benchmarking
- Security review
Skill Templates
Minimal Skill Template
---
name: [skill-name]
version: 1.0.0
description: [Brief description]
category: [category]
tags: [tag1, tag2, tag3]
allowed-tools:
- Read
- Write
---
# [Skill Name] Expert
[Comprehensive description of the skill's purpose and capabilities]
## Core Concepts
### [Concept 1]
[Explanation with examples]
### [Concept 2]
[Explanation with examples]
## Code Examples
### Example 1: [Title]
```[language]
// Code example with detailed comments
```
[Explanation of the example]
## Best Practices
1. **[Practice 1]**: [Rationale]
2. **[Practice 2]**: [Rationale]
## Advanced Patterns
### [Pattern Name]
[Description and implementation]
## Troubleshooting
### Issue: [Common Problem]
**Solution**: [Resolution steps]
## References
- [Official Documentation](url)
- [Community Resources](url)
Full-Featured Skill Template
See examples in stdlib/ai/ai-architect-expert/SKILL.md for comprehensive structure.
Best Practices for Skill Creation
1. Domain Expertise Depth
- Deep, not broad: Focus on specific domain mastery
- Practical over theoretical: Emphasize actionable knowledge
- Current best practices: Keep content up-to-date
- Real-world scenarios: Include production-ready examples
2. Code Quality
- Executable examples: All code should be runnable
- Comprehensive comments: Explain non-obvious logic
- Error handling: Show proper error management
- Security awareness: No hardcoded secrets, safe patterns
3. Documentation Excellence
- Clear structure: Logical flow from basics to advanced
- Consistent formatting: Use standard markdown conventions
- Complete examples: Show full context, not just snippets
- Cross-references: Link to related skills and concepts
4. Maintainability
- Semantic versioning: Follow semver for versions
- Changelog tracking: Document changes between versions
- Deprecation notices: Warn about outdated patterns
- Migration guides: Help users upgrade
5. Integration Patterns
- Dependency declaration: Clearly state requirements
- Composition examples: Show skill combinations
- Tool restrictions: Minimal, justified allowed-tools
- Namespace awareness: Avoid conflicts with other skills
Skill Quality Checklist
Advanced Features
Skill Composition Patterns
// Example: Composite skill that combines multiple experts
const fullStackSkill = {
name: 'fullstack-web-developer',
composition: [
'react-expert', // Frontend
'nodejs-expert', // Backend
'postgresql-expert', // Database
'docker-expert', // Deployment
'aws-expert', // Cloud
],
coordinationStrategy: 'collaborative',
};
Dynamic Skill Loading
class SkillLoader {
/**
* Load skill with dependency resolution
*/
async loadSkill(name: string): Promise<Skill> {
const skill = await this.fetchSkill(name);
const dependencies = skill.metadata.dependencies || [];
// Recursively load dependencies
const loadedDeps = await Promise.all(
dependencies.map((dep) => this.loadSkill(dep))
);
return {
...skill,
dependencies: loadedDeps,
};
}
}
Skill Versioning Strategy
interface SkillVersion {
version: string;
releaseDate: string;
changes: {
breaking: string[];
features: string[];
fixes: string[];
deprecated: string[];
};
migrationGuide?: string;
}
// Example changelog
const changelog: SkillVersion[] = [
{
version: '2.0.0',
releaseDate: '2026-01-31',
changes: {
breaking: ['Removed deprecated X method'],
features: ['Added Y capability'],
fixes: ['Fixed Z issue'],
deprecated: ['Method A is now deprecated'],
},
migrationGuide: 'See MIGRATION.md for upgrade path',
},
];
Reference Documentation
Detailed material lives alongside this skill and is read on demand:
- Skill Creation Framework — Domain Analysis Template, Skill Structure Generator, Skill Validation Engine, Interactive Skill Builder
References
Related Skills
standards-expert - For compliance and best practices
ai-architect-expert - For AI/ML skill design patterns
testing-expert - For skill validation strategies
documentation-expert - For comprehensive documentation
1---2name: skill-creator-expert3version: 1.1.04description: >-5 Expert system for designing, creating, and validating PCL skills with comprehensive6 domain knowledge extraction. Use when the user mentions skill creation, meta programming,7 domain modeling, knowledge engineering, or PCL development, or when the task involves8 Skill Design Principles, Skill Architecture Patterns, Quality & Validation, or Domain9 Analysis Template.10category: tools11tags:12 [13 skill-creation,14 meta-programming,15 domain-modeling,16 knowledge-engineering,17 pcl-development,18 ]19allowed-tools:20 - Read21 - Write22 - Edit23 - Execute24metadata:25 source: https://skillmd.com/skills/personamanagmentlayer/skill-creator-expert26---2728# Skill Creator Expert2930Master skill architect for designing, implementing, and validating high-quality PCL skills. Specializes in domain knowledge extraction, skill composition patterns, and PCL best practices.3132## Core Competencies3334### Skill Design Principles3536- Domain analysis and knowledge extraction37- Skill scope definition and boundaries38- Dependency mapping and composition39- Tool allowlist configuration40- Version management and evolution4142### Skill Architecture Patterns4344- Single-responsibility skills45- Composite skills (orchestration)46- Hierarchical skill structures47- Cross-domain skill integration48- Reusable skill components4950### Quality & Validation5152- Skill testing frameworks53- Documentation completeness54- Example scenario coverage55- Performance benchmarking56- Security review5758## Skill Templates5960### Minimal Skill Template6162````markdown63---64name: [skill-name]65version: 1.0.066description: [Brief description]67category: [category]68tags: [tag1, tag2, tag3]69allowed-tools:70 - Read71 - Write72---7374# [Skill Name] Expert7576[Comprehensive description of the skill's purpose and capabilities]7778## Core Concepts7980### [Concept 1]8182[Explanation with examples]8384### [Concept 2]8586[Explanation with examples]8788## Code Examples8990### Example 1: [Title]9192```[language]93// Code example with detailed comments94```9596[Explanation of the example]9798## Best Practices991001. **[Practice 1]**: [Rationale]1012. **[Practice 2]**: [Rationale]102103## Advanced Patterns104105### [Pattern Name]106107[Description and implementation]108109## Troubleshooting110111### Issue: [Common Problem]112113**Solution**: [Resolution steps]114115## References116117- [Official Documentation](url)118- [Community Resources](url)119````120121### Full-Featured Skill Template122123See examples in `stdlib/ai/ai-architect-expert/SKILL.md` for comprehensive structure.124125## Best Practices for Skill Creation126127### 1. Domain Expertise Depth128129- **Deep, not broad**: Focus on specific domain mastery130- **Practical over theoretical**: Emphasize actionable knowledge131- **Current best practices**: Keep content up-to-date132- **Real-world scenarios**: Include production-ready examples133134### 2. Code Quality135136- **Executable examples**: All code should be runnable137- **Comprehensive comments**: Explain non-obvious logic138- **Error handling**: Show proper error management139- **Security awareness**: No hardcoded secrets, safe patterns140141### 3. Documentation Excellence142143- **Clear structure**: Logical flow from basics to advanced144- **Consistent formatting**: Use standard markdown conventions145- **Complete examples**: Show full context, not just snippets146- **Cross-references**: Link to related skills and concepts147148### 4. Maintainability149150- **Semantic versioning**: Follow semver for versions151- **Changelog tracking**: Document changes between versions152- **Deprecation notices**: Warn about outdated patterns153- **Migration guides**: Help users upgrade154155### 5. Integration Patterns156157- **Dependency declaration**: Clearly state requirements158- **Composition examples**: Show skill combinations159- **Tool restrictions**: Minimal, justified allowed-tools160- **Namespace awareness**: Avoid conflicts with other skills161162## Skill Quality Checklist163164- [ ] Valid front matter (name, version, description, category, tags)165- [ ] Appropriate allowed-tools list166- [ ] Core concepts section with clear explanations167- [ ] At least 3 comprehensive code examples168- [ ] Best practices with rationale169- [ ] Advanced patterns section170- [ ] Troubleshooting guide171- [ ] References and links172- [ ] No hardcoded secrets or credentials173- [ ] All code examples tested and working174- [ ] Clear integration guidelines175- [ ] Proper error handling in examples176- [ ] Security considerations addressed177- [ ] Version compatibility notes178- [ ] Performance considerations179180## Advanced Features181182### Skill Composition Patterns183184```typescript185// Example: Composite skill that combines multiple experts186const fullStackSkill = {187 name: 'fullstack-web-developer',188 composition: [189 'react-expert', // Frontend190 'nodejs-expert', // Backend191 'postgresql-expert', // Database192 'docker-expert', // Deployment193 'aws-expert', // Cloud194 ],195 coordinationStrategy: 'collaborative',196};197```198199### Dynamic Skill Loading200201```typescript202class SkillLoader {203 /**204 * Load skill with dependency resolution205 */206 async loadSkill(name: string): Promise<Skill> {207 const skill = await this.fetchSkill(name);208 const dependencies = skill.metadata.dependencies || [];209210 // Recursively load dependencies211 const loadedDeps = await Promise.all(212 dependencies.map((dep) => this.loadSkill(dep))213 );214215 return {216 ...skill,217 dependencies: loadedDeps,218 };219 }220}221```222223### Skill Versioning Strategy224225```typescript226interface SkillVersion {227 version: string;228 releaseDate: string;229 changes: {230 breaking: string[];231 features: string[];232 fixes: string[];233 deprecated: string[];234 };235 migrationGuide?: string;236}237238// Example changelog239const changelog: SkillVersion[] = [240 {241 version: '2.0.0',242 releaseDate: '2026-01-31',243 changes: {244 breaking: ['Removed deprecated X method'],245 features: ['Added Y capability'],246 fixes: ['Fixed Z issue'],247 deprecated: ['Method A is now deprecated'],248 },249 migrationGuide: 'See MIGRATION.md for upgrade path',250 },251];252```253254## Reference Documentation255256Detailed material lives alongside this skill and is read on demand:257258- [Skill Creation Framework](references/SKILL_CREATION_FRAMEWORK.md) — Domain Analysis Template, Skill Structure Generator, Skill Validation Engine, Interactive Skill Builder259260## References261262- [PCL Language Reference](../../../docs/reference/LANGUAGE.md)263- [Skill Authoring Guide](../../../docs/SKILL-AUTHORING-GUIDE.md)264- [Skill Composition Patterns](../../../docs/SKILL-COMPOSITION-PATTERNS.md)265- [PCL Standards Compliance](../../../docs/STANDARDS-COMPLIANCE.md)266267## Related Skills268269- `standards-expert` - For compliance and best practices270- `ai-architect-expert` - For AI/ML skill design patterns271- `testing-expert` - For skill validation strategies272- `documentation-expert` - For comprehensive documentation