Agent Skills › ReScienceLab/opc-skills › skill-name

skill-name

GitHub

这是一个通用的技能模板，用于指导如何创建和文档化 Agent Skill。它提供了标准结构、前置条件、快速启动指南、命令示例、脚本说明及故障排除等章节，帮助开发者规范地构建可复用的技能模块。

template/SKILL.md ReScienceLab/opc-skills

Trigger Scenarios

需要创建新的 skill 参考 skill 编写规范搭建技能框架

Install

npx skills add ReScienceLab/opc-skills --skill skill-name -g -y

More Options

Non-standard path

npx skills add https://github.com/ReScienceLab/opc-skills/tree/main/template -g -y

Use without installing

npx skills use ReScienceLab/opc-skills@skill-name

指定 Agent (Claude Code)

npx skills add ReScienceLab/opc-skills --skill skill-name -a claude-code -g -y

安装 repo 全部 skill

npx skills add ReScienceLab/opc-skills --all -g -y

预览 repo 内 skill

npx skills add ReScienceLab/opc-skills --list

SKILL.md

Frontmatter

{
    "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.