CtrlK
BlogDocsLog inGet started
Tessl Logo

mintlify

Build and maintain documentation sites with Mintlify. Use when creating docs pages, configuring navigation, adding components, or setting up API references.

75

Quality

92%

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

85%

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-structured with an explicit verification workflow, but it is somewhat verbose with repeated repo-path reminders and option lists that could be trimmed. Strong overall, with conciseness being the only weak dimension.

Suggestions

Reduce repetition of the parenthetical '(`docs/docs.json` in this repo)' — state the repo's config location once and reference it concisely afterward.

Trim or move the full navigation-pattern and optional-frontmatter option tables into a linked reference, keeping the body focused on the most common decisions.

Cut general writing guidance that Claude already follows (e.g., basic avoid-fill-phrases lists) to tighten the token budget while retaining Mintlify-specific conventions.

DimensionReasoningScore

Conciseness

The ~330-line body is mostly efficient and actionable but includes repeated reminders ("docs/docs.json here" recurs throughout), explanatory guidance Claude largely knows, and lengthy decision tables/options that could be tightened, fitting the level-2 anchor rather than a lean level-3.

2 / 3

Actionability

Provides concrete executable CLI commands, ready-to-use frontmatter and file-structure examples, and component decision tables — copy-paste ready and fully actionable per the level-3 anchor.

3 / 3

Workflow Clarity

A clear 6-step workflow (Understand → Research → Plan → Write → Update navigation → Verify) ends with an explicit verification checklist including validation commands `mint broken-links` and `mint validate`, matching the level-3 anchor with explicit validation checkpoints.

3 / 3

Progressive Disclosure

Content is cleanly organized into single-level sections (Quick reference, Page frontmatter, Workflow, Edge cases, etc.) with clearly signaled external docs links; no bundle files exist, so the well-organized section structure earns a level-3 per the simple-skill note.

3 / 3

Total

11

/

12

Passed

Description

100%

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 specific, well-triggered, complete, and clearly scoped to the Mintlify platform, with third-person voice and an explicit Use-when clause. It is a strong, concise activation description.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Build and maintain documentation sites", "creating docs pages", "configuring navigation", "adding components", "setting up API references" — matching the level-3 anchor of multiple specific concrete actions.

3 / 3

Completeness

Explicitly answers both what it does and when to use it via a "Use when" clause listing triggers, satisfying the level-3 anchor for both what and when.

3 / 3

Trigger Term Quality

Uses natural terms a user would say ("documentation sites", "docs pages", "navigation", "API references") alongside the distinctive keyword "Mintlify", giving good coverage of natural language rather than jargon.

3 / 3

Distinctiveness Conflict Risk

Naming the specific platform "Mintlify" with a clear niche and explicit triggers makes it unlikely to activate for unrelated skills; voice is third person ("Build and maintain").

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
nearai/ironclaw
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.