mcpField
T
test-skill

test-skill

github.com/joshuadavidthomasTesting & quality28756 installsUpdated 2w ago
Repository

About test-skill

A test skill for checking the OpenCode Skills Plugin API. It provides sample files and scripts to exercise skill discovery, loading, file reading, and script execution.

Key features

  1. 01Test skill discovery
  2. 02Load the skill
  3. 03Read Markdown and JSON files
  4. 04Run greeting and argument scripts

Use cases

  1. 01Verify skill listing and loading
  2. 02Test reading supporting files
  3. 03Check script execution and arguments

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/joshuadavidthomas/opencode-agent-skills --skill test-skill

After installing, type/test-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

example-config.json
helper-docs.md
scripts/
echo-args
greet

Details

From the project README

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

Comments

Markdown supported