CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aif-explore

Enter explore mode to investigate ideas, systems, problems, and requirements before planning. Use ultra mode, explicitly or through config, when the user wants a durable adaptive research bundle with an index and only the justified C4, ADR, or dependency artifacts.

Quality

64%

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/aif-explore/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 highly actionable and well-gated, with concrete templates, exact paths, and genuine validation checkpoints, and it uses its reference bundle appropriately with clear one-level-deep navigation. Its main weakness is token efficiency: a 544-line body that restates mode-selection, marker-preservation, and language-policy rules multiple times, much of it duplicating the reference files. Deduplicating the contract detail would materially raise conciseness without losing clarity.

Suggestions

State the ultra opt-in / regular save-prompt rule once (e.g., in Mode Selection) and reference it elsewhere instead of restating it in Artifact Ownership, the plan-exists section, and Guardrails.

Move the verbatim marker, status-value, and compatibility-heading preservation lists out of SKILL.md into ULTRA-RESEARCH-FORMAT.md, keeping only 'preserve the exact markers listed in references/ULTRA-RESEARCH-FORMAT.md' inline.

Compress the language/technical-terms policy in Step 0 to the three stored variables plus a one-line pointer, trimming the multi-bullet keep/translate/mixed exposition.

DimensionReasoningScore

Conciseness

At 544 lines the body restates the same rules repeatedly: the ultra opt-in / 'explicit regular restores the save prompt' rule appears in Mode Selection, Artifact Ownership context, the plan-exists section, and Guardrails; the verbatim-marker preservation list is enumerated twice (in the Step 0 language contract and the regular-mode save section) and again in ULTRA-RESEARCH-FORMAT.md; the language/technical-terms policy consumes dozens of lines. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') rather than 3 — the redundancy is systemic, not occasional.

2 / 5

Actionability

Guidance is largely executable: exact config keys and read order in Step 0, an exact three-option save prompt, a complete research-file skeleton with literal markers, a concrete `mkdir -p "$(dirname ...)"` command, and a numbered 6-step ultra procedure. Minor gaps keep it from 5: the Research Coherence Gate criteria are partly abstract ('understandable without the conversation'), subagent delegation is hedged ('when supported'), and the 'Bundle Integrity Gate' is invoked without local definition.

4 / 5

Workflow Clarity

Sequences are explicit and include real validation checkpoints with feedback loops: the Research Coherence Gate lists four numbered verification criteria, mandates 'Correct or qualify mismatches ... then re-run', and gates session-append on success; the regular save procedure is step-by-step with an option-driven prompt. It falls short of anchor 5 because execution order is scattered across topic-organized sections (config, ownership, mode selection, gates, save) with no single flow summary, and one referenced gate is undefined in this file.

4 / 5

Progressive Disclosure

The bundle structure is solid: three real, well-scoped reference files (ULTRA-RESEARCH-FORMAT.md, PROJECT-HYPOTHESES.md, RETRY-HYPOTHESIS.md), each one level deep and explicitly condition-gated ('In ultra mode, read references/ULTRA-RESEARCH-FORMAT.md completely before choosing a slug'; 'Only when the user asks to ... track a project hypothesis'). It is not 5 because substantial ultra-contract detail (marker names, status values, compatibility headings, inclusion rationale) is inlined in SKILL.md and duplicated in ULTRA-RESEARCH-FORMAT.md rather than living solely in the reference.

4 / 5

Total

14

/

20

Passed

Description

53%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 delivers a clear 'what' and a distinctive niche, but its only explicit 'when' clause governs ultra-mode selection rather than skill invocation, leaving the trigger guidance weakly implied. Natural keywords are present but thin on synonyms and diluted by internal jargon like 'ultra mode', 'C4', and 'ADR'.

Suggestions

Add a skill-level 'Use when...' clause with natural trigger phrases (e.g., 'Use when the user wants to explore an idea, brainstorm, compare options, or investigate a problem before creating a plan').

Replace or gloss internal jargon ('durable adaptive research bundle', 'C4, ADR') with user-recognizable terms, or append parenthetical plain-language glosses so the triggers read naturally.

Enumerate 2-3 more concrete capabilities (e.g., map existing architecture, compare approaches, sketch tradeoffs) to round out coverage beyond 'investigate'.

DimensionReasoningScore

Specificity

Names the domain ("investigate ideas, systems, problems, and requirements before planning") and a concrete artifact outcome ("research bundle with an index"), but the action verbs are generic and "durable adaptive research bundle" is jargon-heavy; coverage of the skill's actual capabilities (codebase exploration, option comparison, diagrams) is partial. It lists fewer, more abstract actions than anchor 4's 'several specific actions', matching anchor 3's '1-2 concrete actions, not comprehensive'.

3 / 5

Completeness

The 'what' is clear ("Enter explore mode to investigate ideas, systems, problems, and requirements before planning"), but the only explicit 'when the user wants...' clause is scoped to selecting ultra mode within the skill, not to invoking the skill itself; the skill-level 'when' is only weakly implied by 'before planning'. Per the guideline capping weak/implied triggers, this matches anchor 3 ('clear what but when is missing or only weakly implied') rather than anchor 4, whose when-clause addresses skill usage.

3 / 5

Trigger Term Quality

"explore", "investigate", "ideas", "problems", "requirements", and "research" are terms a user might naturally say, but "ultra mode", "config", and "C4, ADR, or dependency artifacts" are internal jargon, and common natural variations (brainstorm, discovery, think through, compare options, spike) are absent. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

"Explore ... before planning" plus the research-bundle/C4/ADR artifact framing carves a clear niche distinct from general-purpose skills, with only minor overlap risk against generic brainstorming or research skills — matching anchor 4 ('mostly distinct; minor overlap risk'). Not 5 because the description omits the /aif-plan toolchain context that would make the niche unambiguous, and 'explore ideas and problems' alone could collide with a generic ideation skill.

4 / 5

Total

13

/

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

skill_md_line_count

SKILL.md is long (545 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

lee-to/ai-factory

Path

skills/aif-explore/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.