CtrlK
BlogDocsLog inGet started
Tessl Logo

build-paths

Top-level router for the build-paths skill set. Asks the user one question (which path?), then dispatches to beginner/, intermediate/, or advanced/. Use when the user wants to scaffold an Oracle-AI-DB project but hasn't picked a difficulty yet.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

A tight, well-structured router that gives Claude exact prompts, dispatch rules, validation, and stop conditions. It appropriately defers detail to referenced files rather than inlining it.

Suggestions

Trim the auth-detail asides in the prerequisites section to the essential check (API key present + must not be committed) and move the SigV1/compartment-OCID context to a reference file.

Consolidate overlapping guidance between "Stop conditions" and "What you must NOT do" to reduce redundancy.

DimensionReasoningScore

Conciseness

Mostly efficient and purpose-built, but the prerequisites section carries explanatory asides (SigV1 vs bearer-token, compartment OCID) and the menu's parenthetical flavor detail could be trimmed; the stop-conditions and "What you must NOT do" sections partially overlap.

2 / 3

Actionability

Provides a literal copy-paste menu, concrete verification commands (docker --version, python --version), an explicit dispatch table, and exact stop-condition messages — fully actionable for a router skill.

3 / 3

Workflow Clarity

Steps 0–3 are clearly sequenced with an explicit prerequisites validation checkpoint before handoff, input-handling for non-numeric answers, and explicit stop conditions for error recovery.

3 / 3

Progressive Disclosure

Points to one-level-deep references (README.md, skills/README.md, PLAN.md, per-path SKILL.md) that are clearly signaled and gated by user intent ("only if the user asks..."), with no deep nesting.

3 / 3

Total

11

/

12

Passed

Description

85%

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 precise, third-person description that covers both capability and explicit trigger guidance for a narrow router skill. It is distinguishable from other skills and free of fluff.

Suggestions

Broaden the trigger with more natural phrasings (e.g. "set up an Oracle + AI database project", "build an Oracle RAG/agent app") so users who don't say "scaffold" still match.

Consider mirroring the tier keywords users may drop ("beginner/intermediate/advanced", "RAG", "MCP agent") into the trigger clause for better recall.

DimensionReasoningScore

Specificity

Names concrete actions — "Asks the user one question (which path?), then dispatches to beginner/, intermediate/, or advanced/" — rather than vague language.

3 / 3

Completeness

Clearly answers what (asks one question, dispatches to a tier) and when via an explicit "Use when the user wants to scaffold an Oracle-AI-DB project but hasn't picked a difficulty yet" clause.

3 / 3

Trigger Term Quality

The trigger "scaffold an Oracle-AI-DB project but hasn't picked a difficulty yet" is relevant but leans on niche jargon; it lacks common natural variations a user might actually say.

2 / 3

Distinctiveness Conflict Risk

Scoped to a specific build-paths router with a distinct trigger (undecided difficulty for Oracle-AI-DB scaffolding), making it unlikely to fire for unrelated skills.

3 / 3

Total

11

/

12

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.

Validation15 / 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
oracle-devrel/oracle-ai-developer-hub
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.