CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aif-grounded

Reliability gate for answers. Forces evidence-based reasoning, explicit uncertainty, and “insufficient information” instead of guesses. Use when user says “be 100% sure”, “no hallucinations”, “only if verified”, “grounded answer”, or when stakes are high.

Quality

85%

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

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 delivers a highly actionable, clearly sequenced reliability-gate workflow with explicit validation checkpoints, feedback loops, and copy-paste-ready output templates. Its main weakness is redundancy: the skill-context loading procedure is documented twice with overlapping precedence rules, which pads the token budget without adding guidance value.

Suggestions

Merge the "Shared project skill-context" section and "Step 0: Load Skill Context" into a single step — they repeat the same file list and precedence rules (~25 lines that could be ~10), which is the largest conciseness drain.

Trim meta-commentary such as "they exist because the project's experience proved the default insufficient" and the six-bullet "How to apply" list to the two or three rules that actually change behavior.

Consider moving the generic shell-permission preamble and the skill-context precedence policy into a shared project-level reference file, keeping SKILL.md focused on the gate workflow itself.

DimensionReasoningScore

Conciseness

The core workflow (Steps 1–5) and output templates are lean and earn their tokens, but the skill-context loading instructions are stated twice — the "Shared project skill-context" section and "Step 0: Load Skill Context" repeat the same file list and precedence rules over ~25 lines — and the shell-permission preamble and "Artifact Ownership and Config Policy" section add boilerplate, so it could be meaningfully tightened.

3 / 5

Actionability

As an instruction-only skill the guidance is fully concrete: a three-way classification taxonomy (Repo-grounded / Doc-grounded / External-facts), a precise confidence rule ("100 only if every factual claim is supported by evidence you can point to"), and two copy-paste-ready output templates that cover both the confidence-100 and insufficient-information branches, including "3 concrete checks someone can run/inspect" and "1–3 concrete asks or commands for the user to run".

5 / 5

Workflow Clarity

Steps 0–5 are clearly sequenced, Step 4 is an explicit validation gate, and feedback loops are present: the sub-100 branch prescribes remediation ("To reach 100: 1–3 concrete asks"), and the enforcement rule "If any rule is violated — fix the output before presenting it to the user" plus "Only apply patches once confidence can be 100" give validate-fix-retry behavior. The skill is a read-mostly gate, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the body has clean section headers with no nested references and no bulk reference material inlined where it belongs in a separate file. However, the duplicated skill-context loading instructions across two separate sections is a minor organization gap, and that material could plausibly live in a shared reference, so it fits the 'good structure; minor organization gaps' anchor rather than the ideal split.

4 / 5

Total

17

/

20

Passed

Description

83%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 that clearly states what the skill does and gives explicit, natural-sounding trigger phrases users would actually say. Its main weaknesses are the slightly abstract "reliability gate" framing and the overly broad "when stakes are high" catch-all, which dilute specificity and distinctiveness at the margins.

DimensionReasoningScore

Specificity

Names several concrete behaviors — "Forces evidence-based reasoning, explicit uncertainty, and 'insufficient information' instead of guesses" — though "Reliability gate for answers" is partly abstract framing and coverage of what the gate actually does is not comprehensive, matching the 'several specific actions; minor gaps' anchor rather than the 5.

4 / 5

Completeness

It explicitly answers both 'what' ("Reliability gate for answers. Forces evidence-based reasoning, explicit uncertainty, and 'insufficient information' instead of guesses") and 'when' ("Use when user says 'be 100% sure', 'no hallucinations', 'only if verified', 'grounded answer', or when stakes are high") with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

The quoted phrases "be 100% sure", "no hallucinations", "only if verified", and "grounded answer" are utterances a user would naturally say, giving good keyword coverage, but common variants like "verify this", "cite your sources", "don't guess", or "no assumptions" are missing, so it falls short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The anti-hallucination/reliability niche with distinctive quoted triggers is mostly distinct from other skills, but the broad catch-all "or when stakes is high" invites overlap with high-stakes domain skills (security, finance, legal, medical), which is a minor conflict risk keeping it below the 'minimal conflict risk' anchor.

4 / 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

lee-to/ai-factory

Path

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