joshuadavidthomas/test-skill
A test skill to verify all plugin tools work correctly - use_skill, read_skill_file, run_skill_script, find_skills
npx skills add https://github.com/joshuadavidthomas/opencode-agent-skills --skill test-skill
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 itTake joshuadavidthomas/test-skill from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.