Correct
cursor/plugins
Find the mistakes agents keep repeating in this repo and make each one impossible.
A test skill to verify all plugin tools work correctly - useskill, readskillfile, runskillscript, findskills
MITAuto-check passed
Install Test Skill
$ npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install joshuadavidthomas/opencode-agent-skills test-skill --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/test-skill .claude/skills/test-skill && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "test-skill" agent skill from https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skill into .claude/skills/test-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-skill", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install joshuadavidthomas/opencode-agent-skills test-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.opencode/skills/test-skill .agents/skills/test-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "test-skill" agent skill from https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skill into .agents/skills/test-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-skill", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install joshuadavidthomas/opencode-agent-skills test-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.opencode/skills/test-skill .cursor/skills/test-skill && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "test-skill" agent skill from https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skill into .cursor/skills/test-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-skill", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/joshuadavidthomas/opencode-agent-skills.git --path .opencode/skills/test-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install joshuadavidthomas/opencode-agent-skills test-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.opencode/skills/test-skill .gemini/skills/test-skill && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "test-skill" agent skill from https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skill into .gemini/skills/test-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-skill", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install joshuadavidthomas/opencode-agent-skills test-skillInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/.opencode/skills/test-skill .github/skills/test-skill && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "test-skill" agent skill from https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skill into .github/skills/test-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-skill", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install joshuadavidthomas/opencode-agent-skills test-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshuadavidthomas/opencode-agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.opencode/skills/test-skill .opencode/skills/test-skill && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "test-skill" agent skill from https://github.com/joshuadavidthomas/opencode-agent-skills/tree/main/.opencode/skills/test-skill into .opencode/skills/test-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "test-skill", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
test-skill- GitHub stars
- 277
- Token cost
- ~383 tokens
- SKILL.md length
- 124 words
- Files
- 5 (incl. scripts)
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
A test skill to verify all plugin tools work correctly - useskill, readskillfile, runskillscript, findskills
- Works in 4 steps: use_skill - You're reading this, so it… → read_skill_file - Load… → run_skill_script - Execute greet or… → …
- SKILL.md covers Testing Checklist, Available Files, Example Workflow and Expected Outputs
What it does
Test Skill is an agent skill from joshuadavidthomas/opencode-agent-skills. A test skill to verify all plugin tools work correctly - useskill, readskillfile, runskillscript, findskills
Its SKILL.md is about 380 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `example-config.json` and `helper-docs.md`).
The repository describes itself as: An OpenCode plugin that provides tools for using agent skills. The licence is MIT.
Example prompts
- “/test-skill”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- 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
What it can do on your machine
Read from SKILL.md and the folder at commit 7be05ed. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/, which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Test Skill loads about 383 tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 124 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from joshuadavidthomas/opencode-agent-skills at commit 7be05ed, republished under its MIT licence (© joshuadavidthomas). 124 words, ~383 tokens.
Download SKILL.mdSave it as
.claude/skills/test-skill/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.- name
- test-skill
- description
- A 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:
- use_skill - You're reading this, so it works!
- read_skill_file - Load
example-config.jsonorhelper-docs.md - run_skill_script - Execute
greetorecho-argsscripts - 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_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 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 argsExpected Outputs
When everything works:
use_skillreturns "Skill 'test-skill' loaded." with scripts listedread_skill_filereturns "File 'X' from skill 'test-skill' loaded."run_skill_script greetreturns "Hello from test-skill!"run_skill_script echo-argsreturns the arguments passed to it
© joshuadavidthomas, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 4 other files (scripts) in .opencode/skills/test-skill of joshuadavidthomas/opencode-agent-skills.
- SKILL.md
- example-config.json
- helper-docs.md
- scripts/echo-args
- scripts/greet
Open the folder on GitHubat commit 7be05ed
Compare with similar skills
Test Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Test Skill this skilljoshuadavidthomas/opencode-agent-skills | 277 | — | ~383 | Automated safety check: Pass | MIT | |
| Correctcursor/plugins | 10k | 3 repos | ~612 | Automated safety check: Pass | None | |
| CorrectionNxcoreAI/EverRoom | 3k | — | ~290 | Automated safety check: Pass | Custom licence | |
| Correction Root-Cause Pipelinegarrytan/gbrain | 31k | — | ~3.4k | Automated safety check: Pass | MIT | |
| Audit Correctness Proofben-manes/caffeine | 18k | — | ~275 | Automated safety check: Pass | Apache-2.0 | |
| Review Hog Perspective Logic CorrectnessPostHog/posthog | 40k | — | ~988 | Automated safety check: Pass | Custom licence |
Similar skills
- Official
Correction
NxcoreAI/EverRoom
Compute Room overview corrections—citation corrections as per-claim edits and general corrections as a single proposal.
Correction Root-Cause Pipeline
garrytan/gbrain
Traces a factual error the user points out back to its source (a brain page, a memory file, SOUL.md or USER.md, or a hallucination) and fixes that source instead of just noting the correction.
Audit Correctness Proof
ben-manes/caffeine
Attempt formal correctness proofs for all public cache methods
- Official
Review Hog Perspective Logic Correctness
PostHog/posthog
The Logic & Correctness review perspective for PostHog Review.
Correctness Reviewer
udecode/plate
Always-on code-review persona. An agent skill from udecode/plate.
More from joshuadavidthomas/opencode-agent-skills
Git Helper
joshuadavidthomas/opencode-agent-skills
Provides git workflow assistance, branch management, and commit message optimization
Questions about Test Skill
What does Test Skill do?
A test skill to verify all plugin tools work correctly - useskill, readskillfile, runskillscript, findskills. Test Skill is an agent skill from joshuadavidthomas/opencode-agent-skills.
How do I install Test Skill in Claude Code?
Run `npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a claude-code`. Or copy the skill folder (.opencode/skills/test-skill in joshuadavidthomas/opencode-agent-skills) into .claude/skills/test-skill in your project. Claude Code loads it when a task matches its description.
How do I install Test Skill in Codex?
Run `npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a codex`. Or copy the skill folder (.opencode/skills/test-skill in joshuadavidthomas/opencode-agent-skills) into .agents/skills/test-skill in your project. Codex loads it when a task matches its description.
Can I use Test Skill in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add joshuadavidthomas/opencode-agent-skills --skill test-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/test-skill, .gemini/skills/test-skill, .github/skills/test-skill and .opencode/skills/test-skill in your project.
What does Test Skill need to run?
SKILL.md names no scripts, command-line tools or credentials: Test Skill is instructions for the agent only.
Does Test Skill access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Test Skill safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Test Skill use?
Test Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Test Skill use?
About 383 tokens (SKILL.md is roughly 1.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Test Skill?
Skills that share tags, products or a category with Test Skill: Correct (cursor/plugins, 10k stars), Correction (NxcoreAI/EverRoom, 3k stars), Correction Root-Cause Pipeline (garrytan/gbrain, 31k stars) and Audit Correctness Proof (ben-manes/caffeine, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Test Skill?
joshuadavidthomas (a GitHub user) maintains it in joshuadavidthomas/opencode-agent-skills, which has 277 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 26, 2026.
Source: joshuadavidthomas/opencode-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.