CtrlK
BlogDocsLog inGet started
Tessl Logo

directory-submissions

When the user wants to submit their product to startup, SaaS, AI, or review directories for backlinks, domain rating, and discovery.

46

Quality

48%

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/directory-submissions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Scale 1-5

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

This skill is comprehensive and knowledgeable but severely over-scoped for a single SKILL.md file. It attempts to cover directory submissions, Product Hunt launches, review management, destination page strategy, GEO optimization, community marketing, and content strategy all in one document — most of which should be separate skills or reference files. The actionability is decent for the core submission workflow, but much of the content is strategic marketing advice that Claude already understands, and the sheer volume (~400+ lines) undermines token efficiency.

Suggestions

Move the Product Hunt deep dive, Reviews Playbook, Destination Pages Strategy, GEO section, and Community & Ongoing Distribution into separate reference files, keeping only 2-3 sentence summaries with links in the main SKILL.md.

Remove explanatory marketing rationale (e.g., 'Core Philosophy' section, conversion rate statistics, explanations of why backlinks matter) — Claude understands these concepts and the statistics are better placed in reference files.

Add explicit validation checkpoints to the batch submission workflow: verify each listing goes live, check backlink status, handle rejections with retry guidance, and gate progression between tiers on confirmation.

Trim the 'What NOT to Do' section to 4-5 critical items that Claude might actually get wrong, rather than 12 items that include obvious advice like 'don't lie on comparison pages.'

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines, extensively explaining marketing concepts, SEO strategy, community management, and distribution philosophy that Claude already understands. Sections like 'Core Philosophy,' the GEO deep dive, community distribution tactics, and the full Product Hunt playbook are padded with explanatory context and statistics that don't serve as actionable instructions. Much of this reads like a marketing blog post rather than a concise skill file.

2 / 5

Actionability

The skill provides concrete checklists (Phase 0 readiness), specific commands (curl for backlink verification), detailed timelines (PH 3-week prep), and structured output formats. However, much of the guidance is strategic advice rather than executable steps Claude can directly perform — e.g., 'send each a personal email,' 'post 3-5 times/week on LinkedIn,' and 'book a hunter' are user actions, not Claude actions. The output format section and readiness assessment are genuinely actionable for Claude.

4 / 5

Workflow Clarity

The workflow has a clear 4-step sequence (readiness → tiers → assets → batch submit) with a readiness gate (Phase 0 hard blocks). However, there are no explicit validation checkpoints within the submission workflow itself — no 'verify listing is live before proceeding to next,' no error recovery loops for rejected submissions, and the batch submission step lacks feedback mechanisms. The backlink verification curl command is a good touch but is buried rather than integrated as a mandatory checkpoint.

3 / 5

Progressive Disclosure

The skill references external files appropriately (references/directory-list.md, references/positioning-variations.md, references/submission-tracker-template.csv) and links to related skills. However, the massive amount of inline content — the full Product Hunt playbook, the complete reviews protocol, the entire GEO section, the community marketing guide, and the destination pages strategy — should clearly be in separate reference files. The SKILL.md tries to be both overview and comprehensive guide, defeating the purpose of progressive disclosure. No bundle files were provided to verify references exist.

3 / 5

Total

12

/

20

Passed

Description

47%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 provides a clear 'when' trigger with relevant domain keywords but completely lacks a 'what'—it never explains what concrete actions the skill performs. Users searching for directory submission help would likely find it, but Claude wouldn't know what the skill actually does beyond the triggering context.

Suggestions

Add concrete actions describing what the skill does, e.g., 'Finds relevant directories, generates submission copy, tracks listing status' to address the missing 'what' component.

Include additional trigger terms and synonyms like 'product launch', 'SEO', 'link building', 'product listing', or 'Product Hunt' to improve keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain (submitting products to directories) but provides no concrete actions. It doesn't specify what the skill actually does—e.g., generate listings, find directories, draft submissions, track submissions. The actions are entirely absent.

2 / 5

Completeness

The description has a 'when' clause ('When the user wants to submit...') but the 'what' is essentially missing—it never explains what the skill actually does (e.g., generates submission content, finds directories, automates submissions). Per the rubric, having only 'when' without a clear 'what' caps this at 2.

2 / 5

Trigger Term Quality

Includes several natural keywords users might say: 'startup', 'SaaS', 'AI', 'directories', 'backlinks', 'domain rating', 'discovery'. Missing some common synonyms like 'product launch', 'product listing', 'SEO', 'link building', or 'product hunt'.

4 / 5

Distinctiveness Conflict Risk

The niche of directory submission for backlinks and discovery is fairly specific and unlikely to overlap with most other skills. However, it could potentially overlap with general SEO or marketing skills. The mention of specific directory types (startup, SaaS, AI) helps distinguish it.

4 / 5

Total

12

/

20

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-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.