CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

app-guide

Per-repo app guide for QA agents. Trigger: launch the app, sign in to test, QA run setup, never-do list.

Quality

87%

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

100%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 a model of a lean, instruction-only skill: it states only non-obvious constraints (secrets-as-placeholders policy, ask-don't-reconstruct rule), gives an exact file contract, and closes with a complete copy-paste example. Structure is tight and nothing needs splitting or trimming.

DimensionReasoningScore

Conciseness

The ~40-line body is dense and purposeful: exact file path, a four-row table instead of prose, terse imperatives ("Before any run, read it. If it is missing, ask for it"), and no explanation of concepts Claude already knows. Every token carries a non-obvious constraint or instruction, matching the lean anchor; there is nothing to trim without losing the contract.

5 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: the exact path `.ywai/app-guide.md`, explicit behaviors for both consumption ("Before any run, read it. If it is missing, ask for it — do not reconstruct launch steps from memory") and authoring ("fill in the four sections, list every placeholder name under Secrets, and stop there"), plus a copy-paste-ready example guide covering the common case. No missing steps or pseudocode.

5 / 5

Workflow Clarity

This is a simple single-purpose skill under 50 lines, and the single action is unambiguous with an explicit conditional branch (read before any run; if missing, ask rather than reconstruct), an explicit editing procedure (fill four sections, list placeholders, stop), and a self-check ("A guide longer than a screen is two guides"). No destructive or batch operations exist, so the validation cap does not apply, and the simple-skill exception holds.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no references/, scripts/, or assets/ bundles exist, and none are linked), and the body is organized into clear sections (purpose, four-section table, secrets policy, authoring rules, example). Per the under-50-lines guideline, well-organized sections alone earn the top score.

5 / 5

Total

20

/

20

Passed

Description

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

The description has a clear niche and an explicit, natural trigger clause, which keeps it well above average. Its main weakness is specificity: it names the artifact and its trigger situations but never states the skill's concrete actions (reading the guide before runs, authoring/editing guides to the four-section format).

Suggestions

State the skill's actions concretely, e.g. "Reads the repo's .ywai/app-guide.md before any QA run and writes/edits guides with Launch, Sign-in, Never-do, and Secrets sections."

Add a few natural trigger synonyms such as "start the app", "test account", or "app runbook" to broaden keyword coverage.

Sharpen distinctiveness from generic run-the-app skills by leading with the QA-guide-specific framing (e.g., mention the guide file or the never-do/secrets contract in the trigger clause).

DimensionReasoningScore

Specificity

"Per-repo app guide for QA agents" names the domain, and the trigger list names concrete items ("launch the app", "sign in to test", "never-do list"), but these are user situations rather than the skill's actions — what the skill actually does (read the guide before runs, write/edit guides with the four sections) is not explicitly stated, leaving coverage incomplete. Not a 4 because anchor 4 expects several specific actions with only minor gaps, while here the capability description stops at identifying the artifact.

3 / 5

Completeness

Both halves are present: a "what" ("Per-repo app guide for QA agents") and an explicit trigger clause ("Trigger: launch the app, sign in to test, QA run setup, never-do list"), so the missing-'Use when' cap at 3 does not apply. Not a 5 because the "what" is indirect — it identifies the artifact rather than stating what the skill does with it, and the when-clause could name more concrete trigger phrases.

4 / 5

Trigger Term Quality

"launch the app, sign in to test, QA run setup, never-do list" are natural phrases a user or operator would plausibly say, giving good keyword coverage. Not a 5 because common synonyms and variations are missing (e.g., "start the app", "test account", "app onboarding", "run setup").

4 / 5

Distinctiveness Conflict Risk

The niche is clear (per-repo guides for QA agents, with distinctive terms like "never-do list" and "QA run setup"), so conflict risk is low. Not a 5 because "launch the app" and "sign in to test" overlap with generic run-the-app / app-testing skills, a minor but real overlap with closely related skills.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

YoizenSA/dev-ai-workflow

Path

ywai/skills/app-guide/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.