Skill

Review

Audit score 70

skill-name

resciencelab/opc-skills

Placeholder skill template for agent automation workflows.

What is skill-name?

This is a template skill demonstrating the structure and documentation format for creating installable skills in the ReScienceLab OPC skills repository. Use this as a starting point when building new agent automation capabilities.

Provides a standardized template structure for skill development
Includes example scripts and command patterns
Demonstrates proper documentation and frontmatter formatting
Shows how to organize prerequisites, usage examples, and troubleshooting

How to install skill-name

npx skills add https://github.com/resciencelab/opc-skills --skill skill-name

Claude Code

Cursor

Windsurf

Cline

How to use skill-name

1.Copy the template directory to skills/your-skill-name/
2.Update the YAML frontmatter with your skill name and description
3.Write your skill documentation in SKILL.md
4.Add Python or shell scripts in the scripts/ directory
5.Create usage examples in the examples/ directory
6.Update skills.json with your skill entry
7.Test with your agent before submitting a pull request

Use cases

Good for

Creating a new skill by copying and customizing this template
Understanding the required structure for skill submissions
Learning best practices for skill documentation and organization
Setting up scripts and examples for agent-executable tasks

Who it's for

Skill developers building for ReScienceLab OPC
Contributors creating new agent automation capabilities
Teams standardizing skill documentation across projects

skill-name FAQ

What goes in the YAML frontmatter?

The frontmatter requires a 'name' field (kebab-case identifier) and 'description' field (what the skill does and when to use it, with trigger keywords and 'Use when...' contexts).

Where should I put my scripts?

Place all executable scripts in the scripts/ directory. They should be callable from the skill directory using python3 or shell commands.

How do I document usage?

Include Usage Examples section with bash commands, expected outputs, and both basic and advanced examples. Add a Commands section listing all available commands with their parameters.

What should I include in troubleshooting?

Document common issues with symptoms and step-by-step solutions. Include environment variable setup, API key configuration, and dependency issues.

Full instructions (SKILL.md)

Source of truth, from resciencelab/opc-skills.

name: skill-name description: 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 does
script2.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.