| name | description | version | owner | status | tags | inputs | outputs | tools | permissions | authors | references | last_updated | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| example-skill | Generic reusable skill definition template for workflows, tooling, operational procedures, and domain knowledge. | 1.0.0 | team-name | active | example automation operations |
| summary validation_results generated_artifacts | git docker kubectl terraform | network: true filesystem: write shell: limited |
| ./README.md ./docs/ | YYYY-MM-DD |
SKILL.md
Overview
Sample Skill
Purpose
Describe what this skill is responsible for.
Examples:
- Managing Kubernetes deployments
- Writing Terraform modules
- Reviewing pull requests
- Generating API documentation
- Operating CI/CD pipelines
Scope
In Scope
- Supported responsibilities
- Supported workflows
- Expected automation behavior
Out of Scope
- Unsupported operations
- Manual-only tasks
- Restricted production changes
When To Use This Skill
Use this skill when:
- Condition 1
- Condition 2
- Condition 3
Do NOT use this skill when:
- Out of scope scenario 1
- Out of scope scenario 2
Core Concepts
Concept 1
Explain an important concept relevant to the skill.
Concept 2
Explain another concept.
Terminology
| Term | Definition |
|---|---|
| Example | Example definition |
| Workflow | A repeatable process |
Required Knowledge
Before using this skill, the agent/user should understand:
- Git
- YAML
- Docker
- Kubernetes
- CI/CD concepts
Assumptions
- Required tooling is installed
- Required access has been granted
- Repository structure follows organizational standards
References
Documentation
- Internal Wiki
- Runbooks
- API Documentation
Related Skills
- CI/CD
- Infrastructure as Code
- Observability
- Security Review
Change Log
v1.0.0
- Initial version