
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.
$ npx -y skills add joshuadavidthomas/opencode-agent-skills --skill test-skill --agent claude-codeInstalls into .claude/skills of the current project.
This skill exists to verify the OpenCode Skills Plugin API works correctly.
Use this skill to verify:
example-config.json or helper-docs.mdgreet or echo-args scriptsSKILL.md - This file (the main skill content)helper-docs.md - Additional documentation to test read_skill_fileexample-config.json - Sample config file to test non-markdown loadingscripts/greet - Simple script that prints a greetingscripts/echo-args - Script that echoes back its arguments1. 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
When everything works:
use_skill returns "Skill 'test-skill' loaded." with scripts listedread_skill_file returns "File 'X' from skill 'test-skill' loaded."run_skill_script greet returns "Hello from test-skill!"run_skill_script echo-args returns the arguments passed to itSponsors