CtrlK
BlogDocsLog inGet started
Tessl Logo

circle

Circle integration. Manage data, records, and automate workflows. Use when the user wants to interact with Circle data.

55

Quality

62%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/circle/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.

The body delivers highly actionable, executable membrane guidance with a strong, checkpointed connection workflow and clean section structure. Its main weakness is a verbose marketing introduction and the absence of validation guidance for destructive actions.

Suggestions

Trim or remove the introductory marketing paragraph about what Circle is, since Claude does not need that background.

Add a validation/verification step for destructive and batch actions (e.g. confirm a post exists before delete-post, or verify inputs against the schema before running).

Consider moving the full popular-actions table to a reference file and keeping only the most common examples inline to lighten the SKILL.md body.

DimensionReasoningScore

Conciseness

Mostly efficient command-based guidance, but the marketing-style intro ('Circle is a community platform that helps creators and brands...') and a few padded sentences explain context Claude does not need.

3 / 5

Actionability

Provides fully executable membrane commands with flags, a concrete popular-actions table with keys, and proxy examples; minor gaps remain where placeholders like CONNECTION_ID must be supplied.

4 / 5

Workflow Clarity

The connection workflow is clearly sequenced with state-based checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and polling feedback loops, though the listed destructive actions lack explicit validation steps.

4 / 5

Progressive Disclosure

Content is organized into clear, well-labeled sections with no nested references and appropriately inline material for a CLI-integration skill of this size; the popular-actions table is large but suitably placed.

4 / 5

Total

15

/

20

Passed

Description

57%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.

The description successfully pairs a what-statement with an explicit use-when trigger and names a specific app, giving it good distinctiveness. Its main weakness is generic, non-concrete action verbs and limited trigger-term variety.

Suggestions

Replace generic verbs with concrete Circle actions, e.g. 'List members and posts, create spaces and topics, manage events in Circle communities.'

Expand trigger terms with natural synonyms users would say, such as 'community,' 'posts,' 'spaces,' 'members,' and 'events'.

Tighten the 'Use when' clause to reference specific Circle tasks rather than the vague 'interact with Circle data'.

DimensionReasoningScore

Specificity

Names the Circle domain but the actions are generic ('Manage data, records, and automate workflows') with no concrete Circle-specific operations like listing posts or creating spaces.

2 / 5

Completeness

It states both what ('Circle integration. Manage data, records, and automate workflows') and when ('Use when the user wants to interact with Circle data'), though the trigger clause is somewhat generic.

4 / 5

Trigger Term Quality

'Circle' and 'interact with Circle data' provide some relevant natural keywords, but common variations and synonyms (community, posts, spaces, members) are missing.

3 / 5

Distinctiveness Conflict Risk

Naming the specific Circle app gives it a clear niche with minimal conflict risk, though the generic 'manage data, records' phrasing leaves minor overlap with other integration skills.

4 / 5

Total

13

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
membranedev/application-skills
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.