mcpbeat

Test Skill

joshuadavidthomas/test-skill

A test skill to verify all plugin tools work correctly - use_skill, read_skill_file, run_skill_script, find_skills

740 tokens
context cost
the whole folder, loaded on every use
5
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
253
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/joshuadavidthomas/opencode-agent-skills --skill test-skill

The instruction itself

5 sections, as written by the author

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

Expected Outputs

When everything works:

  • use_skill returns "Skill 'test-skill' loaded." with scripts listed
  • read_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 it

How to use it

Copy the folder

Take joshuadavidthomas/test-skill from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

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.