$npx -y skills add ReScienceLab/opc-skills --skill templateClear description of what this skill does and when to use it. Include trigger keywords and contexts inline, e.g. "Use when user wants to X, Y, or Z.
| 1 | # Skill Name |
| 2 | |
| 3 | Brief description of the skill and its purpose. |
| 4 | |
| 5 | ## Prerequisites |
| 6 | |
| 7 | List any setup requirements: |
| 8 | - Environment variables needed |
| 9 | - API keys required |
| 10 | - Dependencies (already listed in frontmatter above) |
| 11 | |
| 12 | Example setup: |
| 13 | ```bash |
| 14 | export SKILL_API_KEY="your_api_key" |
| 15 | ``` |
| 16 | |
| 17 | ## Quick Start |
| 18 | |
| 19 | How to use the skill quickly: |
| 20 | |
| 21 | ```bash |
| 22 | cd <skill_directory> |
| 23 | python3 scripts/command.py --option value |
| 24 | ``` |
| 25 | |
| 26 | ## Usage Examples |
| 27 | |
| 28 | ### Example 1: Basic usage |
| 29 | |
| 30 | ```bash |
| 31 | python3 scripts/script.py "input" |
| 32 | ``` |
| 33 | |
| 34 | Output: |
| 35 | ``` |
| 36 | Expected output here |
| 37 | ``` |
| 38 | |
| 39 | ### Example 2: Advanced usage |
| 40 | |
| 41 | ```bash |
| 42 | python3 scripts/script.py "input" --flag --option value |
| 43 | ``` |
| 44 | |
| 45 | ## Commands |
| 46 | |
| 47 | All commands run from the skill directory. |
| 48 | |
| 49 | ### Command 1 |
| 50 | ```bash |
| 51 | python3 scripts/script1.py --help |
| 52 | python3 scripts/script1.py "param1" --option value |
| 53 | ``` |
| 54 | |
| 55 | ### Command 2 |
| 56 | ```bash |
| 57 | python3 scripts/script2.py "param1" "param2" |
| 58 | ``` |
| 59 | |
| 60 | ## Scripts |
| 61 | |
| 62 | - `script1.py` - Description of what this script does |
| 63 | - `script2.py` - Description of what this script does |
| 64 | |
| 65 | ## API Info |
| 66 | |
| 67 | - **Base URL**: (if applicable) |
| 68 | - **Rate Limits**: (if applicable) |
| 69 | - **Auth**: (how authentication works) |
| 70 | - **Docs**: Link to official documentation |
| 71 | |
| 72 | ## Troubleshooting |
| 73 | |
| 74 | ### Issue 1 |
| 75 | |
| 76 | **Symptom**: Description of the problem |
| 77 | |
| 78 | **Solution**: |
| 79 | 1. Step 1 |
| 80 | 2. Step 2 |
| 81 | |
| 82 | ### Issue 2 |
| 83 | |
| 84 | **Symptom**: Description of the problem |
| 85 | |
| 86 | **Solution**: |
| 87 | 1. Step 1 |
| 88 | 2. Step 2 |
| 89 | |
| 90 | ## Examples |
| 91 | |
| 92 | See `examples/` directory for full workflow examples. |
| 93 | |
| 94 | ## References |
| 95 | |
| 96 | - [Official Documentation](https://example.com) |
| 97 | - [API Reference](https://example.com/api) |
| 98 | - [Related Skill](https://github.com/ReScienceLab/opc-skills/tree/main/skills/related-skill) |
| 99 | |
| 100 | ## Notes |
| 101 | |
| 102 | - Important note 1 |
| 103 | - Important note 2 |
| 104 | |
| 105 | --- |
| 106 | |
| 107 | ## Frontmatter Guide |
| 108 | |
| 109 | The YAML frontmatter at the top of this file is required: |
| 110 | |
| 111 | | Field | Type | Required | Description | |
| 112 | |-------|------|----------|-------------| |
| 113 | | `name` | string | ✓ | Unique identifier (kebab-case) | |
| 114 | | `description` | string | ✓ | What the skill does and when to use it. Include trigger keywords and "Use when..." contexts inline. | |
| 115 | |
| 116 | ## Creating Your Skill |
| 117 | |
| 118 | 1. Copy this template to `skills/your-skill-name/` |
| 119 | 2. Update the YAML frontmatter |
| 120 | 3. Write your SKILL.md documentation |
| 121 | 4. Add Python/shell scripts in `scripts/` |
| 122 | 5. Add usage examples in `examples/` |
| 123 | 6. Update `skills.json` with your skill entry |
| 124 | 7. Test with your agent before submitting PR |