CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

invention-structuring

Structure a raw invention idea into a formal invention disclosure. Use when user says "构建发明", "structure invention", "发明构建", "invention disclosure", or wants to formalize a rough idea into a patent-ready structure.

Quality

75%

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/invention-structuring/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 strongly structured, largely actionable workflow for invention decomposition with concrete tables, templates, and a reviewer validation step. Its main weaknesses are the dense, redundant reviewer-routing boilerplate at the top and a defined but unused refinement loop, which leave the validation feedback path implicit.

Suggestions

Replace the opening reviewer-routing blockquote with a single line pointing to `../shared-references/reviewer-backends.md`, and drop the duplicated routing caveat in Step 6.

Define the refinement loop that `MAX_REFINEMENT_ROUNDS = 3` implies: when the reviewer flags issues, revise the decomposition/claim plan and re-run validation, stopping after 3 rounds.

Clarify Inputs by marking which of the four inputs are required vs. optional (e.g., PRIOR_ART_REPORT.md and NOVELTY_ASSESSMENT.md appear to be prerequisites for deriving the Technical Problem).

DimensionReasoningScore

Conciseness

The workflow body (tables, dependency diagram, output template) is efficient, but the opening reviewer-routing blockquote ("resolve invocation → `.aris/reviewer.json` → Claude Code default (Codex MCP) with `reviewer_route.py` through the canonical helper resolver, preserving this slot's tier, fresh contexts, source/image inputs and deterministic gates") is dense boilerplate largely irrelevant to invention structuring, and Step 6 repeats its content. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not severely padded (1-2) but not clean of over-explanation (4).

3 / 5

Actionability

Concrete, near-executable guidance throughout: the copy-paste-ready `mcp__codex__codex` call with model and reasoning-effort config, category/drawing tables, the claim-hierarchy ASCII template, and a full output markdown template. It falls short of fully-executable (5) due to placeholders like "[Problem-Solution-Advantage summary]", the undefined consumption of `MAX_REFINEMENT_ROUNDS`, and ambiguity about which reviewer backend/contract actually applies after the routing caveat — minor gaps consistent with anchor 4.

4 / 5

Workflow Clarity

The seven steps are clearly sequenced and Step 6 provides an explicit validation checkpoint, but the feedback loop is missing: `MAX_REFINEMENT_ROUNDS = 3` is defined yet the workflow never says what to do when the reviewer finds problems (revise decomposition? re-validate? when to stop?). The sequence-present-but-checkpoints-implicit gap fits anchor 3 better than anchor 4, whose 'most checkpoints present' standard the absent refine-and-revalidate loop undermines.

3 / 5

Progressive Disclosure

Structure is good: well-organized sections with two clearly signaled, one-level-deep references ("Load `../shared-references/patent-writing-principles.md`" in a dedicated Shared References section). Not anchor 5 because the reviewer-routing protocol is inlined in a blockquote instead of being pushed to `reviewer-backends.md`, and the cross-bundle `../shared-references/` paths could not be verified to exist in the skill's environment. Still clearly above anchor 3's 'references present but not clearly signaled'.

4 / 5

Total

14

/

20

Passed

Description

82%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 well-formed description: explicit what and when clauses, natural bilingual trigger phrases, third-person voice, and a clearly distinct niche. The only weakness is that it describes a single restated action rather than enumerating the skill's concrete capabilities.

Suggestions

Enumerate one or two more distinct capabilities (e.g., decompose features into core/supporting/optional layers, plan claim categories and drawings) instead of restating the same structuring action twice.

DimensionReasoningScore

Specificity

"Structure a raw invention idea into a formal invention disclosure" names the domain and essentially one concrete action (structuring/formalizing), restated as "formalize a rough idea into a patent-ready structure" rather than a list of distinct capabilities. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'; it does not list several specific actions (4) but is far more concrete than generic domain-naming (2).

3 / 5

Completeness

It explicitly answers both what ("Structure a raw invention idea into a formal invention disclosure") and when ("Use when user says ... or wants to formalize a rough idea into a patent-ready structure") with concrete trigger phrases — a direct match to the anchor 5 example pattern. Third-person voice is used correctly, so no penalty applies.

5 / 5

Trigger Term Quality

Triggers include "构建发明", "structure invention", "发明构建", "invention disclosure", and "formalize a rough idea into a patent-ready structure" — good coverage with word-order and bilingual synonyms. A few natural terms are missing (e.g., "patent disclosure", "专利", "draft an invention"), so it falls just short of the comprehensive-synonym anchor 5 but is clearly above anchor 3.

4 / 5

Distinctiveness Conflict Risk

The patent/invention-disclosure niche is distinct and the triggers (including Chinese phrases) are unlikely to fire for unrelated skills, matching 'Clear niche with distinct triggers; minimal conflict risk'. It is not merely 'mostly distinct' (4) — no realistic overlap with a differently-scoped skill is evident.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

13

/

16

Passed

Repository

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/invention-structuring/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.