Agent skill
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."
Install this agent skill to your Project
npx add-skill https://github.com/ReScienceLab/opc-skills/tree/main/template
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
seo-geo
SEO & GEO (Generative Engine Optimization) for websites. Analyze keywords, generate schema markup, optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Use when user wants to improve search visibility.
add-new-opc-skill
Checklist and automation guide for adding a new skill to the OPC Skills project. Ensures all required files, metadata, logos, and listings are created before release. Use when adding a new skill, publishing a skill, or preparing a skill for release.
archive
Archive session learnings, debugging solutions, and deployment logs to .archive/yyyy-mm-dd/ as indexed markdown with searchable tags. Use when completing a significant task, resolving a tricky bug, deploying, or when the user says "archive this". Maintains .archive/MEMORY.md index for cross-session knowledge reuse.
banner-creator
Create banners using AI image generation. Discuss format/style, generate variations, iterate with user feedback, crop to target ratio. Use when user wants to create a banner, header, hero image, cover image, GitHub banner, Twitter header, or readme banner.
seo-geo
SEO & GEO (Generative Engine Optimization) for websites. Analyze keywords, generate schema markup, optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Use when user wants to improve search visibility, search optimization, search ranking, AI visibility, ChatGPT ranking, Google AI Overview, indexing, JSON-LD, meta tags, or keyword research.
producthunt
Search and retrieve content from Product Hunt. Get posts, topics, users, and collections via the GraphQL API. Use when user mentions Product Hunt, PH, or product launches.
Didn't find tool you were looking for?