CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

generate2dmedia

The art-route layer of the Forge skills. route_media.py is the one command that generates an image or an image-to-video clip - through the paid API of any provider whose key is configured (OpenAI, Google Gemini, xAI, BytePlus ModelArk, fal.ai; the configured key is the owner's consent), else through the user's own signed-in Codex or Grok CLI - and prints one JSON line with the route, artifact, sha256 and cost estimate; with no route it answers no-route (codeart2d is then the last resort). Also the capability check (forge_doctor), API key configuration, the spend ledger, resume and Codex image adoption. Use when a Forge skill sends a generation here, for the capability check, or when the user asks about keys, routes or spend. Not for planning, processing or QA of sprites, video frames or maps (generate2dsprite, video2dsprite, generate2dmap) or for code-drawn art (codeart2d).

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, information-dense routing reference: every need maps to an exact command with flags, outputs and exit codes, and detailed material is correctly pushed into real one-level-deep reference files. The two dimensions at 4 reflect inline dated/versioned metadata that will age in place, and a top-level workflow that must be assembled from sections rather than read as one validated sequence.

Suggestions

Move time-sensitive provenance markers ('owner decision 2026-10-06', 'last verified 2026-10-06') into provider-survey.md or a dated verification section so SKILL.md stays evergreen (conciseness).

Add a short top-level 4-step sequence — run forge_doctor once per session, resolve or --dry-run, generate, hand the artifact to the owning skill for QA — so the session workflow reads as one validated checklist instead of being implied across sections (workflow_clarity).

State what generate_media.py batch validates per job (or point to the reference that defines it), since batch operations without stated validation cap workflow clarity (workflow_clarity).

DimensionReasoningScore

Conciseness

The body is dense and operational throughout — need-to-command tables, env var names, config paths, exit codes — with no explanations of concepts Claude already knows, so it is well above anchor 3. It stops short of anchor 5 ('every token earns its place') because of inline time-sensitive details: '(owner decision 2026-10-06)', 'last verified 2026-10-06, with the shutdown dates', and version-pinned model lists ('gpt-image-2.5-sunburst', 'gemini-3.1-flash-image') that will age and could largely live in the referenced files, matching anchor 4's 'minor instances of over-explanation that could be trimmed'.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with concrete flags cover the common cases: 'route_media.py image --prompt-file <txt> --reference <png> --size 1024x1024 --out-dir <new>', 'video --prompt-file <txt> --reference <still.png> --last-frame <still.png> --duration 6 --resolution 720p', '--dry-run', and lower-level entries like 'cli_media.py adopt --codex-thread <thread-id> --output-dir <new>'. Expected outputs and exit codes are specified exactly ('exits 0', '{"status":"no-route",...} and exits 3', 'one error: <route>: <code>: <message> line and exits 1'); nothing is pseudocode or merely descriptive.

5 / 5

Workflow Clarity

Route order is an explicit numbered sequence with fallback and error rules ('a route whose account cannot serve the request... passes it to the next route; a refusal such as moderation stops', 'no-route... exit 3' to codeart2d), plus recovery paths ('cli_media.py resume --run <id>, then --adopt (never reruns the CLI)') and pre-spend checkpoints (--dry-run, forge_doctor once per session). It is not 5 because the top-level session flow — doctor, resolve/dry-run, generate, hand off for QA — is implied across sections rather than presented as one validated sequence, and the batch commands ('generate_media.py batch') carry no stated per-job validation here.

4 / 5

Progressive Disclosure

A ~68-line overview whose detail is appropriately split into real, verified, one-level-deep bundle files: 'Details: [route-media.md](references/route-media.md)', '[api-usage.md](references/api-usage.md)', '[cli-routes.md](references/cli-routes.md)', 'Providers: [provider-survey.md]', 'capabilities: references/capabilities.json', 'prices: references/prices.json', 'data contracts: references/schemas/media.schema.json', 'Agent setups: [agent-profiles/README.md]' — every cited path exists on disk, and no reference chain nests deeper than one level. This matches anchor 5's 'clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

18

/

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: it explicitly answers both what and when, enumerates concrete capabilities including output format and fallback behavior, and disambiguates against every sibling skill by name. The only weakness is keyword coverage — a few natural user phrasings (edit, animate, cost/budget) are absent, and the density of the single long sentence works against scannability.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions covering the tool's full surface: 'generates an image or an image-to-video clip', 'prints one JSON line with the route, artifact, sha256 and cost estimate', plus 'the capability check (forge_doctor), API key configuration, the spend ledger, resume and Codex image adoption'. This matches the anchor-5 'multiple specific concrete actions; comprehensive coverage' example; anchor 4's 'minor gaps in coverage' does not apply since generation, routing, checking, keys, spend, resume and adoption are all named.

5 / 5

Completeness

Both parts are explicit with concrete trigger phrases: what — 'route_media.py is the one command that generates an image or an image-to-video clip... and prints one JSON line with the route, artifact, sha256 and cost estimate'; when — 'Use when a Forge skill sends a generation here, for the capability check, or when the user asks about keys, routes or spend'. This mirrors the anchor-5 good example's what+when structure; it is not 4 because the when-clause is fully explicit rather than 'could be more specific'.

5 / 5

Trigger Term Quality

Good natural-term coverage: 'generates an image', 'image-to-video clip', 'keys, routes or spend', and real names users would say (OpenAI, Google Gemini, xAI, fal.ai, Codex, Grok). It falls between anchor 3 and anchor 5: a few common user phrasings are missing (e.g. 'edit'/'reference edit' appears only as a technical aside, no 'animate', 'cost'/'budget' synonyms, no file extensions), which is exactly anchor 4's 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

A clear niche is stated ('The art-route layer of the Forge skills') and every closely related sibling is explicitly excluded by name: 'Not for planning, processing or QA of sprites, video frames or maps (generate2dsprite, video2dsprite, generate2dmap) or for code-drawn art (codeart2d)'. Anchor 4's 'minor overlap risk with closely related skills' is already mitigated by these named exclusions, so anchor 5's 'clear niche with distinct triggers; minimal conflict risk' is the best fit.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 deeper-than-1-level, 4 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

0x0funky/agent-sprite-forge

Path

skills/generate2dmedia/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.