A test skill for checking whether a plugin can load skills, read supporting files, run scripts, and find other skills. It includes sample files and simple greeting and argument-echo scripts.

Use it to test skill loading, file reading, script execution, and skill discovery.

It provides a small, repeatable way to verify that the plugin tools work as expected. It is for testing the tool system rather than building an application.

How joshuadavidthomas/opencode-agent-skills configures OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to joshuadavidthomas/opencode-agent-skills. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/joshuadavidthomas/opencode-agent-skills/main/.opencode/skills/test-skill/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills

Made for: OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/joshuadavidthomas/opencode-agent-skills/test-skill/github.svg)](https://agentmods.dev/skills/joshuadavidthomas/opencode-agent-skills/test-skill)

Your own site

<a href="https://agentmods.dev/skills/joshuadavidthomas/opencode-agent-skills/test-skill"><img src="https://agentmods.dev/badge/skills/joshuadavidthomas/opencode-agent-skills/test-skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/joshuadavidthomas/opencode-agent-skills/test-skill"><img src="https://agentmods.dev/badge/skills/joshuadavidthomas/opencode-agent-skills/test-skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 385 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00029	$0.00385
Opus 5.5	$0.00012	$0.00154
Sonnet 5.5	$0.00006	$0.00077
Haiku 4.5	$0.00003	$0.00038

Measured 2mo ago against content hash afe8f11368de, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

test-skill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.opencode/skills/test-skill/SKILL.md · 44 lines

What it actually says

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

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 44 lines · 29 tokens per session scan A afe8f11368de

Subscribe to this mod's changes

test-skill is a skill published in the GitHub repository joshuadavidthomas/opencode-agent-skills (287 stars, last pushed yesterday), licensed MIT. It adds 29 tokens to every session and 385 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Building agents Testing

research-engineer

An uncompromising Academic Research Engineer. Operates with absolute scientific rigor, objective criticism, and zero flair. Focuses on theoretical correctness, formal verification, and optimal implementation across any required technology.

davila7/claude-code-templates · 43 tokens

tika-eval-compare

Compare extracts from two Tika builds over a corpus to detect regressions in content, encoding, exceptions, and embedded-document handling. Use for "compare before/after extracts", "eval this change against the corpus".

apache/tika · 50 tokens

cua-driver

Use Cua Driver for desktop or browser tasks that are awkward or unavailable through Bash/APIs, or when the user explicitly wants GUI interaction: app testing, visual bug reproduction, form filling, calendar entry, screenshots, and demo recording. Also covers Cua setup; not OpenAI Codex Computer Use or web research.

davidondrej/skills · 68 tokens

opencode-agent-skills: Skill for OpenCode