CtrlK
BlogDocsLog inGet started
Tessl Logo

oma-dev-workflow

Configure development tasks, git hooks, CI/CD, or release automation. Use when creating or fixing a repository development workflow.

61

Quality

71%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/oma-dev-workflow/SKILL.md

The canonical home for this skill is oma-dev-workflow in first-fluke/oh-my-agent

SKILL.md
Quality
Evals
Security

Quality

Content

67%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.

The technical core is excellent — executable mise commands, correct monorepo/TOML configuration details, and a useful troubleshooting table — but it is buried in a large amount of abstract scaffolding (scenes, SSL primitives, intent signatures, keyword lists, empty headings) and redundant dual workflow descriptions that waste context. Reference signaling is well done, though the referenced resource files are not present in the bundle to verify.

Suggestions

Delete the meta-framework filler: the 'SSL primitive' Actions table, 'Intent signature', 'Scenes' (PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE), 'Knowledge Reference' keyword list, and the empty 'Execution Protocol (CLI Mode)' section — none of it changes what Claude does.

Collapse 'Structural Flow' and 'How to Execute' into a single sequential workflow so there is one authoritative path.

Trim the 26-item guardrails list to the non-obvious rules (TOML quoting, monorepo_root requirement, changed-scope validation) and move generic advice (validate before commit, don't ignore failures) into the already-referenced resources files.

DimensionReasoningScore

Conciseness

The ~350-line body contains several padded sections that add no instructional value: the 'SSL primitive' actions table, the 'Intent signature'/'Scenes' (PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE) meta-framework, a 'Knowledge Reference' keyword list, an empty 'Execution Protocol (CLI Mode)' heading, and three overlapping workflow descriptions ('Structural Flow', 'How to Execute') — matching the 2 anchor's 'several unnecessary explanations or padded sections'. It avoids the 1 anchor because it does not explain basic concepts Claude already knows and its technical core (mise commands, TOML config) is genuinely useful.

2 / 5

Actionability

Commands are copy-paste ready and cover the common cases: install/activation ('curl https://mise.run | sh', 'mise install'), discovery ('mise tasks --all'), execution ('mise run //apps/api:dev'), parallelism ('mise run lint ::: test'), concrete TOML config blocks (monorepo_root, task depends), and a troubleshooting table with specific commands ('lsof -ti:PORT'). This matches the 5 anchor's fully executable, common-case-covering guidance; it is above 4 because gaps are negligible.

5 / 5

Workflow Clarity

A clear sequence exists with validation checkpoints (VERIFY scene, 'Verify Results' step, guardrails 9 and 14 on checking exit codes) and an explicit failure-and-recovery section (missing task → 'mise tasks --all', missing runtime → 'mise install', hangs → check prompts, destructive tasks → require confirmation), matching the 4 anchor. It falls short of 5 because the workflow is described redundantly in two competing forms ('Structural Flow' scenes and 'How to Execute') plus an empty 'Execution Protocol (CLI Mode)' heading, which muddies which path to follow; it stays above 3 because validation is explicit, not missing.

4 / 5

Progressive Disclosure

The 'Reference Guide' table cleanly signals six one-level-deep resources with topic and 'When to Load' conditions, plus two shared-protocol references — good structure matching the 4 anchor. No bundle files (references/, scripts/, assets/) are present to verify the 'resources/*.md' and '../_shared/core/*' paths exist, and a sizable share of inline content (26-item guardrails list, troubleshooting table, env-var patterns) overlaps topics the referenced files already cover, keeping it below the 5 anchor's 'content appropriately split'.

4 / 5

Total

15

/

20

Passed

Description

75%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 solid description with an explicit 'Use when' clause and several natural trigger terms in a well-defined dev-workflow niche. Its main weaknesses are the circular, generic 'when' clause and the absence of the skill's distinctive domain vocabulary (mise, monorepo, lint/typecheck/test, dev servers) that would sharpen triggers and reduce overlap with generic CI/git skills.

Suggestions

Rewrite the 'when' clause with concrete trigger phrases, e.g. 'Use when the user mentions mise, monorepo tasks, dev servers, lint/typecheck/test runs, pre-commit hooks, CI pipelines, migrations, or release automation'.

Include the skill's defining technology (mise) in the description to differentiate it from generic CI/CD or git skills.

State 1-2 more concrete capabilities (e.g., 'run parallel lint/test across apps', 'set up pre-commit validation') to close the specificity gap.

DimensionReasoningScore

Specificity

Lists several concrete action areas — 'Configure development tasks, git hooks, CI/CD, or release automation' — going beyond 1-2 actions, but coverage has gaps (no mention of mise, monorepo task running, migrations, or troubleshooting that the skill actually handles), so it falls short of the comprehensive 5 anchor.

4 / 5

Completeness

Both what ('Configure development tasks, git hooks, CI/CD, or release automation') and an explicit when ('Use when creating or fixing a repository development workflow') are present, but the when clause is generic and somewhat circular — restating the what rather than giving concrete trigger phrases like 'setting up pre-commit hooks' or 'CI pipeline failing' — matching the 4 anchor where 'when' could be more explicit.

4 / 5

Trigger Term Quality

Natural phrases like 'git hooks', 'CI/CD', and 'release automation' are terms users would genuinely say, giving good keyword coverage; however common variations for this skill's actual domain (mise, monorepo, lint/test/build, dev server, pipeline) are missing, keeping it below the 5 anchor's 'comprehensive coverage including synonyms'.

4 / 5

Distinctiveness Conflict Risk

The repository development-workflow niche is mostly distinct from feature-implementation skills, with minor overlap risk with closely related git or CI skills; it lacks a sharply differentiating marker (e.g., mise or monorepo) that would earn the clear-niche 5 anchor, but it is more bounded than the 3 anchor's 'could still overlap with similar skills'.

4 / 5

Total

16

/

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
first-fluke/oh-my-agent
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.