test-skill

joshuadavidthomas's avatarfrom joshuadavidthomas

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

⭐7stars🔀2forks📁View on GitHub🕐Updated Dec 19, 2025
[Testing and QA]

When & Why to Use This Skill

This Claude skill serves as a vital diagnostic utility designed to verify the functional integrity of the OpenCode Skills Plugin API. It provides a standardized environment to test core agentic capabilities such as tool discovery, file system access, and script execution, ensuring that the underlying infrastructure is correctly configured for complex automation tasks.

Use Cases

  • Initial Environment Validation: Run this skill immediately after installing the OpenCode Skills Plugin to ensure all core API components are communicating correctly with the Claude agent.
  • Plugin Debugging and Troubleshooting: Use the built-in 'greet' and 'echo-args' scripts to isolate whether execution errors are stemming from the plugin infrastructure or specific custom skill logic.
  • Permission and Path Verification: Confirm the agent's ability to locate, read, and process different file types (JSON, Markdown) across the skill directory to ensure proper data handling.
  • Workflow Benchmarking: Utilize the example workflow to establish a baseline for tool response times and successful orchestration of multi-step plugin commands.
nametest-skill
descriptionA test skill to verify all plugin tools work correctly - use_skill, read_skill_file, run_skill_script, find_skills

Test Skill

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

Testing Checklist

Use this skill to verify:

  1. use_skill - You're reading this, so it works!
  2. read_skill_file - Load example-config.json or helper-docs.md
  3. run_skill_script - Execute greet or echo-args scripts
  4. 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