mirror of
https://github.com/ReScienceLab/opc-skills.git
synced 2026-09-14 18:03:27 +08:00
2aedb75dba
* fix(install-stats): handle abbreviated count formats (e.g. 2.8K) in skills.sh scraper The regex only matched plain digit counts (\d+), causing it to miss abbreviated formats like '2.8K'. This led to seo-geo stealing logo-creator's count and logo-creator being dropped entirely. - Add _parse_count() helper to handle K-suffix abbreviations - Update regex to capture abbreviated count patterns - Refresh install-stats.json with correct data * refactor(skills): align SKILL.md frontmatter with Anthropic skill standard (#51) Remove separate 'triggers' field from all SKILL.md files and merge trigger keywords into the 'description' field. This follows the Anthropic skills standard (skills.sh/anthropics/skills/skill-creator) where frontmatter only has 'name' and 'description'. Updated: all 9 skills and the template.
2.5 KiB
2.5 KiB
name, description
| name | description |
|---|---|
| skill-name | Clear 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." |
Skill Name
Brief description of the skill and its purpose.
Prerequisites
List any setup requirements:
- Environment variables needed
- API keys required
- Dependencies (already listed in frontmatter above)
Example setup:
export SKILL_API_KEY="your_api_key"
Quick Start
How to use the skill quickly:
cd <skill_directory>
python3 scripts/command.py --option value
Usage Examples
Example 1: Basic usage
python3 scripts/script.py "input"
Output:
Expected output here
Example 2: Advanced usage
python3 scripts/script.py "input" --flag --option value
Commands
All commands run from the skill directory.
Command 1
python3 scripts/script1.py --help
python3 scripts/script1.py "param1" --option value
Command 2
python3 scripts/script2.py "param1" "param2"
Scripts
script1.py- Description of what this script doesscript2.py- Description of what this script does
API Info
- Base URL: (if applicable)
- Rate Limits: (if applicable)
- Auth: (how authentication works)
- Docs: Link to official documentation
Troubleshooting
Issue 1
Symptom: Description of the problem
Solution:
- Step 1
- Step 2
Issue 2
Symptom: Description of the problem
Solution:
- Step 1
- Step 2
Examples
See examples/ directory for full workflow examples.
References
Notes
- Important note 1
- Important note 2
Frontmatter Guide
The YAML frontmatter at the top of this file is required:
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | ✓ | Unique identifier (kebab-case) |
description |
string | ✓ | What the skill does and when to use it. Include trigger keywords and "Use when..." contexts inline. |
Creating Your Skill
- Copy this template to
skills/your-skill-name/ - Update the YAML frontmatter
- Write your SKILL.md documentation
- Add Python/shell scripts in
scripts/ - Add usage examples in
examples/ - Update
skills.jsonwith your skill entry - Test with your agent before submitting PR