ralph-tui-create-json

Convert PRDs to prd.json format for ralph-tui execution. Creates JSON task files with user stories, acceptance criteria, and dependencies. Triggers on: create prd.json, convert to json, ralph json, create json tasks.

1.21x

Quality

77%

Does it follow best practices?

Impact

100%

1.21x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/ralph-tui-create-json/SKILL.md

Quality

Content

71%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 highly actionable, well-sequenced instruction skill with concrete schemas, anti-patterns, and a worked example. Its main weaknesses are repeated JSON-schema duplication inflating length and a monolithic single-file structure with no external references or error-recovery loop.

Suggestions

Deduplicate the JSON schema: show the canonical template once in Output Format and have the anti-patterns and worked Example reference or diff against it rather than re-pasting the full structure.

Add an explicit validation step before saving (e.g., parse the JSON / check for circular dependsOn / confirm every dependsOn ID exists) with a fix-and-retry loop, raising workflow_clarity.

Move the full worked Example (and optionally the anti-pattern gallery) into a one-level-deep reference file (e.g. references/EXAMPLES.md) linked from the body to improve progressive_disclosure and reduce inline bulk.

Dimension	Reasoning	Score
Conciseness	The body assumes Claude's competence (no primers on PRDs/JSON) and is mostly efficient, but the same JSON schema recurs three times — Output Format, the CORRECT anti-pattern example, and the full worked Example — which is more than minor redundancy and could be tightened.	3 / 5
Actionability	Provides copy-paste-ready JSON templates with exact field names, a fully filled-in worked example, numbered conversion rules, branchName derivation, and the executable command `ralph-tui run --prd ./tasks/prd.json`, covering the common cases concretely.	5 / 5
Workflow Clarity	A clear 5-step job sequence plus 9 conversion rules and an 8-item pre-save checklist give solid checkpoints, but there is no explicit validate→fix→retry feedback loop, leaving a minor validation gap for a generation workflow.	4 / 5
Progressive Disclosure	No bundle files exist (references/scripts/assets absent) and all ~387 lines live in one monolithic file; sections are well-headed, but the full worked example and anti-pattern gallery are inline content that could be split into a one-level-deep reference for easier navigation.	3 / 5
	Total	15 / 20 Passed

Description

83%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, third-person description that clearly states both capability and explicit trigger phrases tied to a specific tool. It is comprehensive on the what/when axis with only minor gaps in action breadth and trigger synonym coverage.

Dimension	Reasoning	Score
Specificity	Names the domain (PRDs to prd.json) and enumerates several concrete outputs — "user stories, acceptance criteria, and dependencies" — but the actions reduce to a single convert/create workflow, leaving minor coverage gaps versus a fully comprehensive action list.	4 / 5
Completeness	It explicitly answers both what ("Convert PRDs to prd.json... Creates JSON task files with user stories, acceptance criteria, and dependencies") and when ("Triggers on: ...") with concrete trigger phrases, so it is not subject to the missing-trigger cap.	5 / 5
Trigger Term Quality	"Triggers on: create prd.json, convert to json, ralph json, create json tasks" supplies several natural phrases a user would say, though it leans on a few near-duplicates and omits obvious synonyms/file-extension variants.	4 / 5
Distinctiveness Conflict Risk	The ralph-tui and prd.json anchors carve a clear niche with minimal conflict risk, but generic triggers like "convert to json" and "create json tasks" retain minor overlap with other JSON-creation skills.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

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: subsy/ralph-tui
Path: skills/ralph-tui-create-json/SKILL.md
Commit: af44322

Reviewed: 12 days ago

Table of Contents

Discovery Implementation Validation

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.