CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

opencode-configure

Configure OpenCode via opencode.json and AGENTS.md with deterministic provider setup, model selection, permission policies, formatter behavior, and environment variable handling; use when editing opencode configuration, setting model/provider defaults, tightening agent permissions, or troubleshooting OpenCode config behavior.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

66%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured with a clear workflow and genuinely good progressive disclosure into real reference files, but it is undermined by inline JSON examples whose schema contradicts the skill's own config-schema reference, three sections of duplicated content, and broken eval links. The strongest material is the workflow and anti-pattern guidance; the weakest is executable correctness of the headline examples.

Suggestions

Align the inline opencode.json examples with references/config-schema.md: replace the 'providers' array with 'baseEnv' entries with the documented 'provider' object map using '{env:VAR}' apiKey options, and replace 'permissions': {'filesystem', 'shell'} with the documented 'permission': {'edit', 'bash', 'webfetch'} structure, so copy-paste examples are actually valid.

Remove or merge redundant sections: drop the 'Information Architecture' TOC (headers already navigate), fold 'Quick Commands' into the Workflow (they repeat steps 4-5 verbatim), and consolidate 'Quick Start' with 'Configuration Examples'.

Fix or remove the 'Eval Scenarios' section — the three links point to evals/scenario-0..2/task.md but no evals/ directory exists in the bundle.

DimensionReasoningScore

Conciseness

The body contains several structurally redundant sections: the 'Information Architecture' bullet list duplicates the file's own headers as a table of contents, 'Quick Commands' repeats the exact commands already embedded in Workflow steps 4-5, and 'Quick Start' overlaps the 'Configuration Examples' section with a near-identical provider JSON block. This is 'mostly efficient but could be tightened' rather than score 4, where over-explanation would be only minor instances — here three whole sections could be removed or merged with no loss of information.

3 / 5

Actionability

Concrete commands (jq, rg, opencode run) and full JSON/markdown templates exist, but the primary copy-paste examples contradict the skill's own references/config-schema.md: SKILL.md shows a top-level 'providers' array with 'baseEnv' and 'default: true' model entries and a 'permissions' object with 'filesystem'/'shell' keys, while the bundled schema documents 'provider' (object map with '{env:...}' apiKey options), 'permission' with 'edit'/'bash'/'webfetch' keys, and 'model': 'provider/model-id'. A user copy-pasting the inline examples produces config the skill's own reference says is invalid — concrete guidance with a substantive correctness gap, not the 'minor gaps' of score 4.

3 / 5

Workflow Clarity

The six-step Workflow has an explicit sequence with two validation checkpoints ('jq . opencode.json >/dev/null', smoke test 'opencode run "test"') and a stated error-recovery loop ('If errors surface, re-read config precedence before widening permissions'). This matches the top anchor — clear sequence, explicit validation steps, feedback loop for error recovery — and the destructive/batch cap of 3 does not apply because verification is present.

5 / 5

Progressive Disclosure

Structure is good: a references table with a 'When to Use' column clearly signals three one-level-deep reference files that all exist, and deep field material is correctly kept in references/config-schema.md rather than inlined. It falls short of score 5 because the 'Eval Scenarios' section links to evals/scenario-0..2/task.md and no evals/ directory exists in the bundle — three dead navigation links — and the 'Information Architecture' hub adds a redundant navigation layer.

4 / 5

Total

15

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A model description: third-person voice, concrete multi-area capability list tied to named files, and an explicit 'use when' clause with natural trigger phrases covering edit, defaults, permissions, and troubleshooting use cases. No vague fluff or over-claims are present.

DimensionReasoningScore

Specificity

The description lists multiple concrete capability areas — 'deterministic provider setup, model selection, permission policies, formatter behavior, and environment variable handling' — anchored to two named files (opencode.json, AGENTS.md). Coverage of the configuration domain is comprehensive, matching the 'multiple specific concrete actions' anchor; not score 4 because no meaningful capability area is missing, and not below because every action named is concrete rather than generic.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' ('Configure OpenCode via opencode.json and AGENTS.md with...') and the 'when' ('use when editing opencode configuration, setting model/provider defaults, tightening agent permissions, or troubleshooting OpenCode config behavior'). The explicit 'use when' clause with four concrete triggers matches the top anchor exactly, so the missing-'when' cap of 3 does not apply and score 4's 'when could be more explicit' does not fit.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are present: 'editing opencode configuration', 'setting model/provider defaults', 'tightening agent permissions', 'troubleshooting OpenCode config behavior', plus the key filenames opencode.json and AGENTS.md. This covers the domain's natural vocabulary including file names, matching the comprehensive-coverage anchor; it does not fit score 4 because no common phrasing for this domain (config edit, defaults, permissions, troubleshooting) is absent.

5 / 5

Distinctiveness Conflict Risk

The description names a specific tool (OpenCode) and its specific config files, giving it a clear niche with distinct triggers. Overlap risk with general config or Claude Code configuration skills is minimal since every trigger is qualified by OpenCode; not score 4 because there is no meaningful overlap with a closely related skill's trigger set.

5 / 5

Total

20

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 missing, 3 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

pantheon-org/tekhne

Path

skills/agentic-harness/opencode-toolkit/configure/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.