CtrlK
BlogDocsLog inGet started
Tessl Logo

endor-setup

Onboarding wizard for Endor Labs. Guides users through prerequisites, MCP server configuration, authentication, namespace setup, and running their first scan. Use when the user says "endor setup", "configure endor", "endor auth", "set up endor", "install endor", "endor onboarding", or when any MCP tool fails with an auth or namespace error. Do NOT use when the user already has a working setup — route to specific skills instead.

72

Quality

88%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

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.

This is an excellent skill description that hits all the marks. It provides specific concrete actions, comprehensive natural trigger terms, explicit 'Use when' and 'Do NOT use when' clauses, and clear boundaries that distinguish it from other Endor Labs skills. The description is concise yet thorough, serving as a strong example of how to write skill descriptions.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'prerequisites, MCP server configuration, authentication, namespace setup, and running their first scan.' These are clear, actionable steps rather than vague language.

3 / 3

Completeness

Clearly answers both 'what' (guides users through prerequisites, MCP server configuration, authentication, namespace setup, first scan) and 'when' (explicit 'Use when...' clause with specific trigger phrases and error conditions). Also includes a 'Do NOT use when' clause for additional clarity.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'endor setup', 'configure endor', 'endor auth', 'set up endor', 'install endor', 'endor onboarding'. Also includes contextual triggers like 'auth or namespace error'. These are realistic phrases users would naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive — scoped specifically to Endor Labs onboarding with clear trigger terms. The 'Do NOT use when the user already has a working setup — route to specific skills instead' clause explicitly delineates boundaries, reducing conflict with other Endor-related skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-crafted onboarding wizard with excellent actionability and workflow clarity. The two-workflow branching (Local Development vs Multi-Namespace) with explicit conflict detection is a strong design choice. The main weakness is verbosity — Node.js installation instructions, the congratulatory success template, and the MCP tools reference table add bulk without proportional value for Claude, and the document could benefit from splitting some reference content into separate files.

Suggestions

Remove or drastically shorten the Node.js installation section — Claude knows how to install Node.js and can provide OS-specific instructions on demand.

Move the 'Available MCP Tools After Setup' table and the 'Success' congratulatory template to a separate reference file to reduce the main skill's token footprint.

Remove the 'Step 6: Success' section entirely or reduce it to a single line pointing to a help command — the markdown template is unnecessary padding that Claude can generate contextually.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary content: the Node.js installation instructions (multiple OS variants), the full MCP tools table at the end, and the 'Success' step with markdown template are padding. Claude knows how to install Node.js and doesn't need the congratulatory template. However, the auth workflow tables and conflict detection logic are genuinely useful non-obvious information.

2 / 3

Actionability

The skill provides fully executable commands at every step, complete JSON configuration blocks for both workflows, specific bash commands for verification, and concrete troubleshooting solutions. The auth workflow decision table with specific env var names and the conflict detection commands are highly actionable.

3 / 3

Workflow Clarity

The 6-step sequence is clearly ordered with explicit validation checkpoints: Step 2.3 checks for conflicting auth sources before proceeding, Step 2.5 explicitly requires a restart, Step 5 provides a concrete verification test with expected outcomes, and the troubleshooting table covers common failure modes. The feedback loop for auth conflicts (detect → warn → remove → retry) is well-defined.

3 / 3

Progressive Disclosure

The content is well-structured with clear headings and numbered steps, but it's a long monolithic document (~200+ lines) with no references to external files. The MCP tools table, full Node.js installation instructions, and the success template could be split into separate reference files. However, since no bundle files are provided, the inline approach is the only option, and the section headers do provide reasonable navigation.

2 / 3

Total

10

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
endorlabs/skills-ideas
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.