CtrlK
BlogDocsLog inGet started
Tessl Logo

opencli-sitemap-author

Use when creating or maintaining OpenCLI site sitemaps: agent-facing navigation, page-state, action, workflow, API-reference, pitfall, and fallback knowledge for a website. Use after browser exploration discovers durable site context, when a sitemap is stale, or when promoting local site knowledge into the repo.

64

Quality

77%

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/opencli-sitemap-author/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 well-structured, actionable skill body with concrete schemas, commands, and a clear authoring loop, deferring full field-level spec to one clearly signaled reference. Its main weakness is conciseness — recurring rationale/commentary paragraphs could be trimmed to assume Claude's competence more.

Suggestions

Trim meta-commentary paragraphs (e.g. the 'spec 800 是 lazy-load 优化目标' aside and '比纯 step list 清晰' justification) to instruction-only statements that assume Claude's competence.

Consider moving the size-guidance decision table and partial-scope-rule code examples into references/sitemap-schema.md to keep SKILL.md a lean overview.

Add an explicit validate-then-retry checkpoint to the Authoring Loop (e.g. verify the written sitemap against fresh browser state and fix mismatches before promoting).

DimensionReasoningScore

Conciseness

Mostly efficient and information-dense, but several sections inject meta-commentary and rationale (e.g. "spec 800 是 lazy-load 优化目标 + Phase 2 audit 阈值", "比纯 step list 清晰:consumption skill 看到...") that explain reasoning rather than instruct, and could be tightened.

3 / 5

Actionability

Provides copy-paste-ready YAML action schema, the on_adapter_fail convention, concrete commands (opencli browser state/find/network/analyze), a token-threshold decision table, and ❌/✅ selector examples — mostly executable with only minor template-placeholder gaps.

4 / 5

Workflow Clarity

The numbered Authoring Loop (load → verify → record → stable ids → write local → mark stale on conflict) is a clear sequence with a conflict-resolution checkpoint, but lacks an explicit validate-then-retry feedback loop.

4 / 5

Progressive Disclosure

The body is an overview that clearly signals a single one-level-deep reference (references/sitemap-schema.md) with an explicit contents list, though some inline material (size guidance table, partial scope rule with code) leans toward reference-level detail.

4 / 5

Total

15

/

20

Passed

Description

87%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 defines a niche domain, names concrete content categories, and provides explicit when-triggers covering multiple real scenarios. It is comprehensive on completeness and distinctiveness, with only minor specificity and trigger-synonym gaps.

DimensionReasoningScore

Specificity

Names the domain ("creating or maintaining OpenCLI site sitemaps") and enumerates several concrete content categories — "agent-facing navigation, page-state, action, workflow, API-reference, pitfall, and fallback knowledge" — but the verbs are limited to creating/maintaining with the rest being noun categories, leaving minor coverage gaps.

4 / 5

Completeness

Explicitly answers both what (sitemap authoring for navigation/page-state/action/workflow/API/pitfall/fallback) and when ("Use when creating or maintaining...", "Use after browser exploration discovers durable site context, when a sitemap is stale, or when promoting local site knowledge") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural triggers like "Use when creating or maintaining OpenCLI site sitemaps", "when a sitemap is stale", and "promoting local site knowledge into the repo", giving good keyword coverage, though a few common synonyms are absent.

4 / 5

Distinctiveness Conflict Risk

The OpenCLI site-sitemap niche is specific with distinct triggers, and the qualifier "OpenCLI" plus the agent-execution-graph framing minimizes overlap with unrelated skills.

5 / 5

Total

18

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository
jackwener/OpenCLI
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.