CtrlK
BlogDocsLog inGet started
Tessl Logo

build-paths-advanced

Scaffold an agent system where Oracle AI DB is the *only* state store, composed from the build-paths/skills/ building-block library. Stack — langchain-oracledb + oracle-database-mcp-server + in-DB ONNX embeddings + OCI GenAI Grok 4 + Open WebUI. Three projects — production-feeling NL2SQL+RAG hybrid analyst, self-improving research agent, conversational schema designer. For users who want a real DB-as-only-store agent demo.

68

Quality

83%

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.

An exceptionally actionable, well-sequenced orchestration skill: exact commands, per-idea file specifications, validation with recovery loops, and explicit stop conditions. The main gaps are mild redundancy around the forbidden-imports rule and inline per-idea detail that could live one level deeper in reference files.

DimensionReasoningScore

Conciseness

The body is dense and directive — tables, exact commands, file specs, LOC budgets — with zero padding explaining concepts Claude already knows. It misses anchor 5 because of repetition: the forbidden-imports rule is stated four times (intro rules, Step 2 table, verify.py grep, "What you must NOT do") and the compose-not-boilerplate rule also recurs.

4 / 5

Actionability

Fully executable throughout: exact CLI invocations ("onnx2oracle load all-MiniLM-L6-v2 --name MY_MINILM_V1 --dsn ..."), specific SQL blocks, named file paths per idea, a copy-paste planner-loop skeleton, and concrete per-idea tool/collection tables. This matches the anchor for copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

Steps 0–5 are clearly sequenced with explicit validation checkpoints (verify.py with forbidden-imports grep and OAMP cold→warm round-trip), a recovery loop ("follow shared/verify.md recovery loop, max 3 retries"), confirmation gating before destructive read_write DDL, and a dedicated stop-conditions section. This matches the top anchor including feedback loops and checklists.

5 / 5

Progressive Disclosure

Step 0 explicitly and clearly signals which references to read first ("skills/README.md — the composition pattern", "shared/references/oamp.md — load-bearing for...") and pushes detail out to those files. It falls short of anchor 5 because the referenced bundle files (skills/*, shared/*) are not present in this skill's bundle to verify, and the three per-idea app-code specifications run long inline where a per-idea reference file would keep the overview leaner.

4 / 5

Total

18

/

20

Passed

Description

78%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 highly specific, well-scoped description that names concrete deliverables and a distinctive niche with minimal conflict risk. Its main weakness is the trigger guidance: an audience clause ("For users who want...") substitutes for an explicit "Use when..." statement, and natural-language trigger terms are diluted by stack jargon.

Suggestions

Replace or augment "For users who want a real DB-as-only-store agent demo" with an explicit trigger clause, e.g. "Use when the user asks to build or scaffold a production-feeling agent demo on Oracle AI DB, or requests an advanced NL2SQL/RAG/self-improving agent project with the database as the only state store."

Add user-facing synonyms alongside the stack jargon — e.g. "Oracle Database 23ai agent", "vector-store-in-database demo", "Grok 4 agent" — so the description matches how users actually phrase the request.

State the full lifecycle in the "what" (interview the user, scaffold, verify with a forbidden-imports grep, produce a mandatory executed notebook) so the capability coverage reads as comprehensive rather than scaffolding-only.

DimensionReasoningScore

Specificity

The description opens with a concrete primary action ("Scaffold an agent system where Oracle AI DB is the *only* state store") and enumerates specific stack components and three named project deliverables ("NL2SQL+RAG hybrid analyst, self-improving research agent, conversational schema designer"). It stops short of anchor 5 because scaffolding is the sole action verb — coverage of what the skill actually does (interview, verify, notebook) is implied rather than listed.

4 / 5

Completeness

The "what" is explicit and concrete (scaffold + stack + three projects). The "when" exists only as an audience clause ("For users who want a real DB-as-only-store agent demo") rather than an explicit "Use when..." trigger, so it fits anchor 4 (both present, when could be more explicit) rather than 5.

4 / 5

Trigger Term Quality

Natural user phrases like "agent system", "NL2SQL", "RAG", "schema designer", and "agent demo" are present alongside concrete deliverable names. It falls short of anchor 5 because several terms are stack jargon ("langchain-oracledb", "OCI GenAI Grok 4", "build-paths/skills/") rather than phrases a user would naturally say, and no synonyms or file extensions are covered.

4 / 5

Distinctiveness Conflict Risk

An extremely specific niche — Oracle AI DB as the sole state store, a named tech stack, and three named project archetypes — with essentially no overlap risk against generic database, agent, or scaffolding skills. Clear distinct triggers; fits anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

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.