CtrlK
BlogDocsLog inGet started
Tessl Logo

leg-curate-requirements-oracle

Curate an Oracle Forms modernization feature by reconciling extracted Oracle evidence, linked screenshots, a running target mockup, its Next.js implementation, existing canonical requirements, and accepted target architecture. Use when a target mockup must be converted or incrementally enriched into a review-ready feature requirement package plus an evidence-backed server-side implementation specification covering UI-to-data mappings, LOVs, validations, detailed decision rows for Delete, Add, Edit, and other operations, Oracle-constraint-to-application-message translations, transactions, tab dependencies, APIs, errors, security, and acceptance scenarios without inventing unsupported physical mappings.

71

Quality

89%

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

81%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 instruction skill: exact paths, commands, key schemes, a 17-step workflow, and thorough validation with feedback loops. Its weaknesses are length and redundancy — several requirement sets are stated three times across sections — which costs tokens without adding guidance, plus one unresolvable parent-skill reference.

Suggestions

Merge the 'Required Content' and 'Validation' enumerations with the corresponding 'Curate Detailed Operation Decisions' and 'Curate Oracle Constraint And Error Translation' sections so each rule set is stated once, cutting the body's length substantially.

Move the long itemized 'Required Content' lists for the two artifacts into references/specification-template.md (already the designated home for exact artifact shapes) and keep only a short summary plus the link in SKILL.md.

Verify or inline the '../leg-curate-requirements/SKILL.md' reference (unresolvable from this bundle), or state the expected deployment location so navigation to the parent skill is reliable.

DimensionReasoningScore

Conciseness

The body is 377 lines and 32KB with no explanations of concepts Claude already knows (no 'what is Oracle Forms' padding), so it is not anchor-2 'several unnecessary explanations'. But it could clearly be tightened: the operation-decision and error-translation requirements are each stated three times (in 'Curate Detailed Operation Decisions'/'Curate Oracle Constraint And Error Translation', again in 'Required Content', and again in 'Validation'), which is unnecessary repetition. This matches anchor 3, 'Mostly efficient but... could be tightened'.

3 / 5

Actionability

The guidance is fully executable for an instruction-only skill: exact repository paths ('agentic-sdlc-data/tenants/<tenant>/projects/<project>/repo'), a concrete input table with defaults, a copy-paste validator invocation with flags ('python <skill-directory>\scripts\validate_specification.py --requirement ... --require-operation-decisions'), concrete key-naming examples ('operation.delete.precheck.child-exists', 'error.constraint.scp-uk1'), and a worked example ('39 hard checks and 15 warnings... represent all 54 rows'). This matches anchor 5; it is not 4 because commands and examples cover the common cases with no material gaps.

5 / 5

Workflow Clarity

A 17-step numbered workflow with explicit validation steps and a feedback loop ('Continue correcting artifacts until all checks pass or a specific evidence or decision blocker remains'), plus concrete validation commands and defined failure semantics (structural errors fail; registered gaps produce readiness findings). This matches anchor 5 ('Clear sequence with explicit validation steps; feedback loops for error recovery'); it is not 4 because checkpoints are explicit throughout, including input validation, coverage-matrix gates, and post-merge re-validation of whole artifacts.

5 / 5

Progressive Disclosure

Good structure with one-level-deep, clearly signaled references that resolve in the bundle: 'Use `references/specification-template.md` for exact artifact shapes and tables' (file exists, 310 lines) and 'scripts/validate_specification.py' (exists with a concrete invocation). It is anchor 4 rather than 5 because the parent reference '../leg-curate-requirements/SKILL.md' is not resolvable within this bundle, and substantial rule lists (e.g., the long 'Required Content' enumerations) remain inline in a 377-line body where further splitting into reference files would aid navigation.

4 / 5

Total

17

/

20

Passed

Description

92%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: concrete, comprehensive, third-person, with an explicit 'Use when...' trigger clause and a clearly delimited Oracle Forms modernization niche. Its main weakness is sheer density — the single 'when' sentence is very long and leans on internal vocabulary, which slightly dilutes natural trigger phrasing.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage: 'Curate an Oracle Forms modernization feature by reconciling extracted Oracle evidence, linked screenshots, a running target mockup, its Next.js implementation' and enumerates concrete deliverables ('UI-to-data mappings, LOVs, validations, detailed decision rows for Delete, Add, Edit... Oracle-constraint-to-application-message translations, transactions, tab dependencies, APIs, errors, security, and acceptance scenarios'). This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' — not 4, since coverage has no material gaps; not below 5 because every named action is concrete rather than generic.

5 / 5

Completeness

Both parts are explicit: the 'what' ('Curate an Oracle Forms modernization feature by reconciling extracted Oracle evidence, linked screenshots, a running target mockup...') and a dedicated trigger clause 'Use when a target mockup must be converted or incrementally enriched into a review-ready feature requirement package plus an evidence-backed server-side implementation specification'. This matches the anchor-5 good example structure (what + 'Use when...' with concrete trigger phrases); not 4 because the 'when' clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Good natural keyword coverage for the niche: 'Oracle Forms modernization', 'target mockup', 'requirement package', 'implementation specification', 'Delete, Add, Edit', 'validations', 'transactions', 'APIs'. It falls at anchor 4 ('Good keyword coverage; a few natural terms missing') rather than 5 because common synonyms a user might say are absent — e.g., 'migration', 'replatforming', 'Forms conversion', 'legacy modernization' as a standalone phrase — and several phrases ('canonical requirements', 'governed') are internal jargon rather than user-spoken terms.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers: 'Oracle Forms modernization' combined with mockup-to-requirement-package conversion is highly unlikely to fire for unrelated skills, matching 'Clear niche with distinct triggers; minimal conflict risk'. It is not 4 because the only overlap risk is with its own declared parent specialization, which the description's Oracle-Forms-specific framing already disambiguates from the general requirements-curation case.

5 / 5

Total

19

/

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
sibendu/ai_tessl
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.