Test Skill

This is purely a testing utility for developers building or debugging Claude Code skills. It's designed to verify that all four plugin API methods work correctly: use_skill, read_skill_file, run_skill_script, and find_skills. You get a handful of sample files (markdown docs, a JSON config) and basic scripts (one that greets, another that echoes arguments back) to confirm your integration is wired up properly. It's not meant for production work. If you're building skills or troubleshooting the plugin system, this gives you a quick sanity check. Otherwise, you won't need it.

GitHub stars: 229
last updated: May 9, 2026

View on GitHub

Install

$ npx -y skills add joshuadavidthomas/opencode-agent-skills --skill test-skill --agent claude-code

Installs into .claude/skills of the current project.

Files

Test Skill

This skill exists to verify the OpenCode Skills Plugin API works correctly.

Testing Checklist

Use this skill to verify:

use_skill - You're reading this, so it works!
read_skill_file - Load example-config.json or helper-docs.md
run_skill_script - Execute greet or echo-args scripts
find_skills - Should list this skill and others

Available Files

SKILL.md - This file (the main skill content)
helper-docs.md - Additional documentation to test read_skill_file
example-config.json - Sample config file to test non-markdown loading
scripts/greet - Simple script that prints a greeting
scripts/echo-args - Script that echoes back its arguments

Example Workflow

1. find_skills              # List available skills
2. use_skill test-skill     # Load this skill (you're here!)
3. read_skill_file test-skill helper-docs.md    # Load supporting docs
4. run_skill_script test-skill greet            # Run a script
5. run_skill_script test-skill echo-args --foo bar  # Run with args