CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

validate-connector

Audit an existing Sim knowledge base connector against the service API docs and repository conventions, then report and fix issues in auth, config fields, pagination, document mapping, tags, and registry entries. Use when validating or repairing code in `apps/sim/connectors/{service}/`.

72

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 an exceptionally actionable, well-sequenced audit procedure with concrete patterns, named utilities, and a genuine fix-and-verify feedback loop. Its weaknesses are modest redundancy in the closing checklist and a monolithic single-file structure that forgoes progressive disclosure for content that would fit naturally in reference files.

Suggestions

Split the severity-grouped report-format examples and service-specific notes (HubSpot 10k cap, Notion-Version, Dropbox-API-Arg, OData/SOQL escaping) into a one-level-deep references/ file (e.g. REPORTING.md), keeping SKILL.md as a concise overview with clearly signaled links.

Remove or collapse the final 'Checklist Summary' section, which duplicates the per-step checklists almost verbatim — the step sections already serve as the checklist.

Move the connector-file inventory in Step 1 (the two path listing code blocks) into a reference file or trim to the essential paths, since it is static lookup material rather than workflow instruction.

DimensionReasoningScore

Conciseness

The body is dense and checklist-driven and assumes Claude's competence (it never explains what OAuth or pagination is), so it is well above the verbose anchors. However, the 'Checklist Summary' section restates the per-step checkboxes almost verbatim (~25 redundant lines), so minor trimming is possible — matching the 'efficient; minor instances' level-4 anchor rather than the every-token-earns-its-place level 5.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact file paths to read, precise escape patterns ("externalId.replace(/'/g, \"''\")", "Math.min(PAGE_SIZE, remaining)", "Buffer.byteLength(text, 'utf8')"), named helpers (fetchWithRetry, parseTagDate, VALIDATE_RETRY_OPTIONS), and exact commands ("bun run lint"). Specific examples cover the common cases, matching the level-5 anchor.

5 / 5

Workflow Clarity

A clear 11-step sequence with an explicit validation feedback loop: report grouped by severity, fix critical/warning issues, run "bun run lint", confirm TypeScript compiles clean, and re-read modified files to verify. As a batch-modification skill its validation checkpoints are present, so it matches the level-5 'explicit validation steps; feedback loops; checklists' anchor.

5 / 5

Progressive Disclosure

Section headers are clear and nothing is buried, but the skill is a ~330-line monolith with no bundle files or one-level-deep references. The severity-grouped report-format examples and service-specific notes (HubSpot, Notion, Dropbox, Salesforce, Linear) are content that clearly belongs in a separate reference file, matching the level-3 'some structure; content that should be separate is inline' anchor rather than level 2, since navigation is easy and organization is otherwise good.

3 / 5

Total

17

/

20

Passed

Description

92%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: it states concrete capabilities (audit, report, fix) with an explicit, well-scoped 'Use when' trigger tied to a specific code path. The only weakness is trigger-term coverage that omits a few natural synonyms users might use.

DimensionReasoningScore

Specificity

"Audit an existing Sim knowledge base connector against the service API docs and repository conventions, then report and fix issues in auth, config fields, pagination, document mapping, tags, and registry entries" names multiple concrete actions (audit, report, fix) with an enumerated, comprehensive list of coverage areas. No meaningful capability is missing, so it matches the comprehensive anchor rather than the 'minor gaps' level 4.

5 / 5

Completeness

It explicitly answers what (audit, report, and fix issues across auth, config fields, pagination, document mapping, tags, registry) and when ("Use when validating or repairing code in `apps/sim/connectors/{service}/`"), matching the level-5 anchor with concrete trigger phrases rather than the weaker 'when' phrasing of level 4.

5 / 5

Trigger Term Quality

"Use when validating or repairing code in `apps/sim/connectors/{service}/`" plus terms like connector and knowledge base give good natural trigger coverage a user would actually say. It falls short of the level-5 anchor because common variations such as "check", "audit", or "fix sync issues" are not included as trigger synonyms.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to Sim knowledge base connectors in a specific repository path, giving it a clear niche with distinct triggers and minimal conflict risk with generic code-review or document skills. It matches the level-5 'clear niche with distinct triggers' anchor.

5 / 5

Total

19

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

itsablabla/jada-ironman

Path

.agents/skills/validate-connector/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.