CtrlK
BlogDocsLog inGet started
Tessl Logo

intent

Shipyard's internal requirements intake for non-engineer contributors (support/ops) — turn a pasted chat log or verbal problem report into a five-section intent.md through numbered batch questioning with a completion gate, walk it through tracker review with harbor's four records, and hand the accepted intent to /launch as its mission brief. Produces decisions, not code.

64

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/intent/SKILL.md
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.

The body is a strong, well-sequenced process document: the numbered conversation protocol with its stop-gate checklist, bounded retry limits, and rejection-driven feedback loop fully satisfy workflow clarity. Actionability is high with a concrete template and grading criteria, held back only by unspecified tracker-record location and inventory display format, and a few provenance/meta sentences cost tokens without guiding execution.

Suggestions

Delete the design-provenance line and other meta-commentary ('no math is borrowed from deep-interview', 'It stands on the verifiability boundary') — they explain pedigree, not action.

Specify the tracker record's file path and field layout as concretely as the intent.md template, since the review workflow depends on them.

Show a minimal example of the opening inventory (known/missing per section) so the first conversational move is unambiguous.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — the protocol, template, and grading test carry real information per token — but a few meta sentences earn nothing at runtime: 'Design provenance: every decision here was pinned by a wayfinder map (7 tickets)…', 'no math is borrowed from deep-interview', and 'It stands on the verifiability boundary'. This is 'efficient; minor instances of over-explanation that could be trimmed' (4), not anchor 5 where every token earns its place.

4 / 5

Actionability

Concrete, executable guidance throughout: a six-step numbered protocol, the full intent.md template, an answer-format example ('1 是; 2 不确定'), the quoted 阻塞 grading test, and explicit paths and statuses. Minor gaps keep it at 4: the tracker record's file location and format are never specified, and the 'opening inventory' display format is only implied.

4 / 5

Workflow Clarity

The conversation is a clearly sequenced numbered process with an explicit validation checklist (the stop gate enumerates pass criteria for all five sections), a re-inventory loop for remaining gaps, bounded retries (soft prompt at round 6, hard cap at round 12), and a feedback loop where rejection reasons drive revision and resubmission. This matches the top anchor: clear sequence, explicit validation steps, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

There are no bundle files (no references/, scripts/, or assets/), so the skill is scored on its single-file organization: clear section headers, a well-signaled template block, and no content that clearly belongs in a separate file. It sits at 'good structure; minor organization gaps' (4) rather than 5 because the downstream Amendment and Conflict sedimentation sections describe post-acceptance processes that could live in a one-level reference file.

4 / 5

Total

17

/

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.

The description is highly specific and distinctive, laying out the complete intake-to-handoff workflow in concrete terms, but it lacks any explicit 'Use when...' trigger clause, capping completeness at 3. Trigger term coverage is good though diluted by internal jargon that end users would not naturally say.

Suggestions

Add an explicit trigger clause, e.g. 'Use when a support/ops contributor pastes raw customer feedback, a chat log, or a verbal problem report, or when continuing an open intent review.'

Replace internal jargon ('harbor's four records', 'mission brief') with natural user-facing terms and add common synonyms such as 'customer feedback', 'bug report', or 'feature request' to improve trigger matching.

State the invocation condition for each input mode (pasted log vs. path to existing intent.md vs. nothing) so 'when' is answered, not just 'what'.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering the full lifecycle — 'turn a pasted chat log or verbal problem report into a five-section intent.md through numbered batch questioning with a completion gate', 'walk it through tracker review with harbor's four records', and 'hand the accepted intent to /launch as its mission brief' — in third person. Coverage is comprehensive across intake, review, and handoff, matching the top anchor rather than the 'several specific actions; minor gaps' anchor below.

5 / 5

Completeness

The 'what' is explicit and detailed, but there is no 'Use when...' clause or equivalent explicit trigger guidance — the audience hint 'for non-engineer contributors (support/ops)' only weakly implies when to invoke it. Per the judging guideline, a missing 'when' clause caps completeness at 3, which this matches exactly.

3 / 5

Trigger Term Quality

Natural phrases like 'pasted chat log', 'verbal problem report', 'requirements intake', and 'support/ops' give good keyword coverage, but internal jargon ('harbor's four records', 'mission brief') dilutes it and common user synonyms like 'customer feedback' or 'bug report' are absent. It sits above anchor 3 (missing common variations) but short of anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

'Shipyard's internal requirements intake', 'intent.md', 'Produces decisions, not code', and the /launch handoff define a clear niche with distinct triggers that no other skill would plausibly claim. This matches the top anchor; it is not anchor 4 because there is no realistic overlap with a closely related skill.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
Yeachan-Heo/oh-my-claudecode
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.