CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

the-provider-runtime-symmetry

Keep Stave's Claude and Codex provider runtimes in sync when editing one of them. Use when a change touches `electron/providers/claude-sdk-runtime.ts`, `electron/providers/codex-app-server-runtime.ts`, executable lookup, env construction, CLI session launch env, tooling status probes, or any provider-agnostic behavior. Trigger on phrases like "provider runtime", "claude adapter", "codex adapter", "sibling adapter", "PATH env", "CLAUDE_CONFIG_DIR", "CODEX_HOME", "tooling status", "어댑터 대칭", "양쪽 프로바이더 확인".

73

Quality

92%

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

88%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.

A high-quality, project-specific parity-audit skill: concrete files, commands, and failure signatures with explicit verification steps. Its only weaknesses are minor redundancy (guardrails restate checklist rules) and a long single-file layout where the upgrade-hygiene material could live in a reference. No bundle files exist, and all referenced docs are real repo files clearly signaled.

DimensionReasoningScore

Conciseness

The body is dense and repo-specific with no basic-concept padding, but has minor trims available: the-ipc-contract-audit is referenced twice (intro and 'Integration With Other Skills') and the Guardrails section restates three rules already covered by the Symmetry Checklist. This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than 'every token earns its place'.

4 / 5

Actionability

Guidance is fully concrete: exact file paths (electron/providers/cli-path-env.ts, electron/main/utils/tooling-status.ts), the command 'bun run typecheck', specific grep targets, and real failure signatures like 'env: node: No such file or directory'. As an instruction-only skill, the absence of code examples is not penalized since the guidance is directly executable.

5 / 5

Workflow Clarity

The skill sequences a 7-part checklist ('Run this before considering an adapter change complete') followed by an explicit Verification section with per-condition validation (both providers, GUI launch, probe surface) and expected error outputs. Clear sequence, explicit validation steps, and checklists for a complex process match the top anchor.

5 / 5

Progressive Disclosure

Good structure with clear sections, a file-role table, and one-level-deep references to real repo docs (docs/providers/codex-upgrade-checklist.md, docs/developer/adding-a-provider.md). At ~130 lines, the specialized 'SDK upgrade hygiene' section is content that could be split into a reference file — a minor organization gap that keeps this below the top anchor.

4 / 5

Total

18

/

20

Passed

Description

95%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 strong description: it clearly states what the skill does and gives an explicit, concrete 'Use when' clause plus natural trigger phrases in two languages. The only limitation is that the action side ('keep in sync') is singular while the enumerated surfaces do the coverage work.

DimensionReasoningScore

Specificity

'Keep Stave's Claude and Codex provider runtimes in sync' plus a concrete list of surfaces ('executable lookup, env construction, CLI session launch env, tooling status probes') names several specifics, but the core what is a single action with enumerated trigger surfaces — matching 'lists several specific actions; minor gaps' rather than the comprehensive multi-action top anchor.

4 / 5

Completeness

Explicitly answers both what ('Keep Stave's Claude and Codex provider runtimes in sync when editing one of them') and when ('Use when a change touches [specific files]... Trigger on phrases like...') with concrete trigger phrases — exactly the top anchor.

5 / 5

Trigger Term Quality

Comprehensive natural terms including synonyms ('provider runtime', 'claude adapter', 'codex adapter', 'sibling adapter'), env-var names users paste from errors ('PATH env', 'CLAUDE_CONFIG_DIR', 'CODEX_HOME'), and Korean phrases ('어댑터 대칭', '양쪽 프로바이더 확인') — full coverage of how real users would phrase the need.

5 / 5

Distinctiveness Conflict Risk

Anchored to exact file paths (electron/providers/claude-sdk-runtime.ts, electron/providers/codex-app-server-runtime.ts) and provider-specific env vars, giving it a clear niche with minimal overlap risk against neighboring skills.

5 / 5

Total

19

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

sendbird/stave

Path

skills/the-provider-runtime-symmetry/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.