CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

2markdown

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

Quality

68%

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/2markdown/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 a coherent, executable CLI workflow for connecting to 2markdown via Membrane, with strong state-handling checkpoints for connection readiness. Main weaknesses are cosmetic-to-moderate: a dangling 'Step 2' reference, a 'Popular actions' section that names no actions, and light padding in the intro and overview sections.

DimensionReasoningScore

Conciseness

The body is command-first and efficient, but has trimmable padding: 'It is used by writers, developers, and content creators...' adds nothing actionable, the '## 2markdown Overview' bullet tree is content-free, and the 'Agent Types' note is loose. Fits anchor 4 (efficient, minor over-explanation) rather than 5, but avoids 3 since the product intro itself is warranted for an obscure tool and no general concepts are re-explained.

4 / 5

Actionability

Concrete executable commands appear throughout — npm install, membrane login with a headless variant, connection ensure with a real URL, polling, action list/run, and a proxy flags table. Fits anchor 4 (mostly executable, minor gaps) rather than 5 because 'Popular actions' lists zero actual actions (only a discovery command) and action-run examples use raw placeholders with no worked conversion example.

4 / 5

Workflow Clarity

The install → login → connect → poll → act sequence is clear, with explicit state-based checkpoints (READY / CLIENT_ACTION_REQUIRED with clientAction breakdown / CONFIGURATION_ERROR handling). Fits anchor 4 rather than 5 because 'skip to **Step 2**' references a step that is never labeled, and '#### 1b' implies a numbering scheme that does not exist elsewhere.

4 / 5

Progressive Disclosure

This is a single-file skill (no references/, scripts/, or assets/ exist) whose content is appropriately sized for one file, with clear section headers, an external docs link, and no nested references. Fits anchor 4 (good structure, content appropriately placed, minor organization gaps such as the empty 'Popular actions' section) rather than 5, since the body exceeds the simple-skill threshold and has minor organizational gaps.

4 / 5

Total

16

/

20

Passed

Description

48%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 has an explicit and appropriately scoped 'Use when' trigger tied to the distinctive 2markdown name, but it fails to state what the skill actually does. 'Manage data, records, and automate workflows' is interchangeable boilerplate that would fit any SaaS integration, so the description leans on the app name alone to carry both capability and trigger information.

Suggestions

Replace the generic 'Manage data, records, and automate workflows' with concrete capabilities, e.g. 'Convert documents (PDF, DOCX, HTML) to Markdown, manage conversion records, and automate 2markdown workflows.'

Expand trigger terms to cover natural user phrasings and synonyms, e.g. 'Use when the user wants to convert documents to Markdown, mentions 2markdown, or needs .md output from other file formats.'

Make the 'what' explicitly answer what 2markdown does (a web app converting document formats into Markdown) so the description is self-contained even for users unfamiliar with the product.

DimensionReasoningScore

Specificity

The only capability statements are 'Manage data, records, and automate workflows', which is generic boilerplate applicable to almost any integration skill; the actual capability (converting document formats to Markdown) is never named. It matches anchor 2 (domain named, actions generic) rather than 3 because no concrete 2markdown-specific action appears.

2 / 5

Completeness

The 'when' is explicit ('Use when the user wants to interact with 2markdown data'), but the 'what' is vague fluff that never states what the skill actually does — the mirror image of anchor 3's profile (strong what, missing when). Not 4, which requires both halves solidly present; the vague 'Manage data, records, and automate workflows' fails the what half.

3 / 5

Trigger Term Quality

'2markdown' and 'interact with 2markdown data' are relevant, distinctive keywords, but natural variations users would say are missing entirely — e.g. 'convert to markdown', 'document conversion', 'md', or supported file formats. Fits anchor 3 (some relevant keywords, missing common variations) rather than 2, since '2markdown' is a genuinely natural term, not purely generic filler.

3 / 5

Distinctiveness Conflict Risk

The distinctive app name in the trigger ('interact with 2markdown data') keeps conflict risk low, matching anchor 4 (mostly distinct, minor overlap risk). Not 5 because the generic 'Manage data, records, and automate workflows' phrasing adds overlap boilerplate, and not 3 because the named-app trigger is more distinct than a generic 'works with document files' description.

4 / 5

Total

12

/

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.

Validation — 15 / 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

Path

skills/2markdown/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.