directory-submissions
When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for backlinks, domain rating, and discovery.
Install / Use
npx skills add coreyhaines31/marketingskills --skill directory-submissionsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of directory-submissions
directory-submissions scores 93/100 on our quality scale, 148th of 1,620 Development & Engineering skills we index (top 10%).
Its SKILL.md is 23 KB long, well organised into 41 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 51,376 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 20 days ago, so directory-submissions is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-09-25. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
directory-submissions compared with similar skills
All 4 of these similar skills score higher than directory-submissions; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| directory-submissions (this skill)by coreyhaines31 | 93 | 51.4k | 20d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 85.3k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 73.7k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 73.2k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 47.1k | today | CLAUDE.md |
Frequently asked questions
- How do I install directory-submissions?
- Run
npx skills add coreyhaines31/marketingskills --skill directory-submissions. The install tabs above show the steps for each supported agent. - Which AI agents does directory-submissions work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is directory-submissions safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is directory-submissions still maintained?
- The repository was last updated 20 days ago, so directory-submissions is actively maintained.
Skill content
View source on GitHubname: directory-submissions description: When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for backlinks, domain rating, and discovery. Also use when the user mentions "directory submissions," "submit to directories," "backlinks from directories," "list my product," "submit to Product Hunt," "BetaList," "TAAFT," "Futurepedia," "G2 listing," "Capterra listing," "AlternativeTo," "SaaSHub," "AI directories," "MCP registry," "agent directory," "dofollow backlinks," "launch directories," or "directory tracker." Use this whenever someone is planning the directory layer of a product launch or an ongoing backlink campaign. For the broader launch moment, see launch. For programmatic SEO pages that should live behind these backlinks, see programmatic-seo. For AI citation optimization, see ai-seo. metadata: version: 2.0.0
Directory Submissions
You are an expert in directory-driven distribution for software products. Your goal is to help the user build a compounding backlink + discovery foundation by submitting to the right directories, in the right order, with the right positioning — and to make sure that foundation actually produces leads instead of vanity backlinks.
Before Starting
Check for product marketing context first:
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Core Philosophy
Directory submissions are the foundation layer of distribution — never the whole strategy. They do three things well:
- Pass dofollow backlinks from high domain-rating sites into your marketing pages. This raises your DR, which makes your entire site easier to rank for competitive keywords.
- Create discovery surface area — people browsing AI/SaaS directories are in-market buyers, not random traffic.
- Get cited by AI engines — ChatGPT, Claude, Perplexity, and Google AI Overviews all pull heavily from high-DR directories when answering "what's the best [category]?" queries. AI-referred traffic converts 6–27× higher than traditional search traffic.
But directories alone will not generate meaningful leads. They exist to pass link equity into the pages that DO generate leads — template galleries, comparison pages, alternative pages, blog posts. Build the destination pages first, then submit to directories so the link equity has somewhere useful to land.
The full directory catalog lives in references/directory-list.md. The positioning variant library lives in references/positioning-variations.md. The submission tracker template lives in references/submission-tracker-template.csv.
The Three Hard Rules
Rule 1: Foundation before submission
Never submit to a directory until the landing page it will link to is live, indexed, and has:
- A single
<h1>and sequential heading hierarchy — pages with clean hierarchy have 2.8× higher AI citation rates, and 87% of ChatGPT-cited pages use a single H1. - A real pricing page (even "free while in beta" counts — most Tier 1 directories require one).
- Privacy policy + terms.
- Logo assets in PNG + SVG + square 1024×1024 + favicon.
- 5–8 real product screenshots at 1920×1080 (not marketing mockups).
- A 60–90 second demo video — products with video on Product Hunt get 2.7× more upvotes.
- FAQ schema markup (AI engines heavily weight
FAQPageJSON-LD for answer extraction). - Structured data:
Organization,Product,SoftwareApplication.
Rule 2: Destination pages before directories
Directories are the source of link equity. You need destinations that can convert the resulting traffic. Minimum destinations before submitting to anything:
- 3–5 competitor alternative pages (
/alternatives/[competitor]) targeting "[competitor] alternative" keywords. Comparison/alternative pages convert at 5–15% vs 0.5–2% for generic content. - 3–5 use-case pages (
/for/[audience]or/use-cases/[use-case]). - Template gallery with 20+ entries (if applicable — this was Typeform's largest SEO growth driver, generating 30K non-branded signups and $3M/year LTV).
- 1 "best of" blog post you wrote yourself about your own category, including honest coverage of competitors.
Rule 3: Positioning varies by directory type
Never copy-paste the same description everywhere. AI engines penalize duplicate content, and each directory audience responds to different framing. See references/positioning-variations.md for the full variant library. Short version:
| Surface | Lead with | Why | |---|---|---| | Startup directories | Outcome | Audience is other founders. They care what it does. | | SaaS directories | Alternative framing | People search "[competitor] alternative" — meet them there. | | AI directories | AI-first architecture | TAAFT/Futurepedia audiences explicitly want AI tools. | | Agent/MCP directories | Agent/MCP angle | Niche but high-intent. A real moat. | | No-code directories | Ease + power | Audience values speed-to-build over depth. | | Dev directories | Technical depth | Dev audiences reward technical substance. | | B2B review sites | ROI + use case | Buyers want outcomes and case studies. |
Workflow
Step 1: Readiness assessment (Phase 0)
Ask the user these 9 questions. If any are "no", they're not ready — help them build the missing piece first.
- Is the product publicly accessible (no password wall)?
- Is there a pricing page (even "free while in beta")?
- Are privacy policy + terms live?
- Logo assets in PNG + SVG + square + favicon?
- 5–8 real screenshots + 60–90s demo video?
- Landing pages GEO-ready (single H1, sequential hierarchy, FAQ schema, structured data)?
- At least 3 alternative pages and 3 use-case pages live and indexed?
- Template gallery or lead magnet asset (if applicable to category)?
- At least 20 beta/early users who could leave a review on G2?
A "no" on any of 1–7 is a hard block. A "no" on 8–9 is a soft block: you can launch but will lose Tier 2 review value and Typeform-style compounding.
Step 2: Choose the tiers
Full catalog in references/directory-list.md. Summary:
| Tier | When | Examples | Typical count | |---|---|---|---| | Tier 1 — Flagship launch | Launch week only | Product Hunt (anchor), BetaList, HN Show HN, Fazier, DevHunt | ~15 | | Tier 2 — Startup/SaaS | Week 1 + rolling | AlternativeTo, SaaSHub, G2, Capterra, F6S, SourceForge, Slashdot | ~50 | | Tier 3 — AI directories | Week 1–3 | TAAFT, Futurepedia, Toolify, Future Tools, aitools.inc, AIStage | ~40 | | Tier 4 — Agent/MCP registries | Week 1–3 (if MCP) | Glama, APITracker, LF MCP Registry, AI Agents List | ~10 | | Tier 5 — No-code directories | Week 1–3 (if no-code) | NoCodeFinder, No Code MBA, We Are No Code, MakerPad | ~8 | | Tier 6 — "Best of" listicles | Rolling outreach | Cold outreach to DR 40+ blog posts | ~10 inclusions | | Tier 7 — Integration marketplaces | When integrations ship | Zapier, HubSpot, Slack, Airtable, Notion | ~5 | | Tier 8 — Profile & content platforms | Rolling | GitHub, WordPress.com, Substack, Dev.to, SlideShare, Behance | ~50 | | Tier 9 — Local business directories | Rolling (if applicable) | Manta, Hotfrog, Locanto, MerchantCircle | ~20 | | Tier 10 — Forums & communities | Rolling (participate first) | SitePoint, GrowthHackers, Warrior Forum, Designer News | ~13 | | Tier 11 — Press release & article sites | Launch + milestones | PRLog, PR.com, EzineArticles, Feedspot | ~25 | | Tier 12 — Social bookmarking | Rolling | Scoop.it, Diigo, Pearltrees | ~5 | | Tier 13 — Niche vertical directories | When vertical fits | Justia (legal), Porch (home), LandBook (design), etc. | ~20 |
Triage rule: Only submit where the product is a genuine fit. Forcing a listing into the wrong category burns the first-submission advantage and gets rejected by moderators.
Step 3: Prepare asset variations
For each tier, prep a distinct description variant (pulled from references/positioning-variations.md):
- Tagline under 10 words
- Short description at 60 chars
- Long description at 150 words
- 5–8 category tags
- Logo assets
- Screenshots + demo video URL
- Founder story (2–3 sentences)
Critical: Don't copy-paste the same long description into every directory. Vary the opening sentence, the feature emphasis, and the audience framing per tier. AI engines cross-reference and down-weight duplicate content.
Step 4: Batch submit
Set up the tracker spreadsheet (references/submission-tracker-template.csv). Work left-to-right through it. 2–3 hours per batch is realistic.
Per submission:
- Copy the tier-appropriate positioning variant.
- Fill in the form.
- Upload assets.
- Submit.
- Log: date, URL, status, moderator notes.
- Once live, verify the backlink exists and is dofollow:
curl -sIL https://directory.com/your-listing | grep -i rel=. If absent, the link is dofollow.
Product Hunt Deep Dive (The Anchor Event)
Product Hunt is the single highest-leverage submission but also the most easily wasted. The 2026 PH algorithm weights comment quality more than upvote count — a post with 50 upvotes + 30 genuine comments ranks above one with 200 upvotes + 5 comments. 80% of failed launches fail because they launched without a warm audience OR asked for upvotes instead of feedback.
3-week prep timeline
- Day -21 to -14: Warm up hunter account. Upvote + thoughtfully comment on 3 launches/day. Follow 100+ active makers. Build history so your account looks real to the algorithm.
- Day -14: Create "Upcoming" page on PH. Drive traffic to it to collect "notify on launch" subscribers.
- Day -10: (Optional) book a hunter. Don't pay cash — trade a feature, shoutout, or intro. A known hunter adds ~15% to day-one momentum but isn't required.
- Day -7: Draft launch-day assets: gallery images (1270×760), tagline, 260-char description, first comment from you, first comment from a customer.
- Day -3: Email list warm-up. "We're launching Tuesday. Here's what to expect. Reply if you want a heads up."
- Day -1: Final check — product works in incognito, video autoplays, CTA goes to signup, PH listing preview looks right.
Launch day execution
- Launch at 12:01 AM Pacific Time. Tuesday, Wednesday, or Thursday only — weekend launches get 60–70% less traffic. The 12:01 AM PT start maximizes your 24-hour window.
- First 2 hours are everything. Need 50+ supporters in the first 2 hours to trigger algorithmic distribution.
- Post the first comment yourself with the story: why you built it, what's different, what to try first.
- Reply to every comment in under 30 minutes. PH measures maker responsiveness.
- Share the link to: Twitter/X thread, LinkedIn long-form post, personal Slack/Discord communities, your email list, Indie Hackers, every power user via DM.
- Never ask for upvotes. Ask for feedback. "Would love your honest take on the positioning" converts 3× better than "support us!" and doesn't trigger the algorithm's anti-manipulation filters.
- Don't message strangers. The community flags this and moderators will hide your post.
Post-launch
- Write a launch recap blog post with numbers + lessons. Honest, not bragging. Publish on day 2.
- Cross-post the recap to Indie Hackers and r/SaaS (where promotion is allowed).
- Only submit to Show HN if you have a technical angle to share (architecture, DSL, novel approach). A generic "we launched a SaaS" post will get flagged to death.
Reviews Playbook (G2 / Capterra / TrustRadius)
G2 and Capterra (now owned by G2 as of Feb 2026) listings are worthless without reviews. 10 reviews is the magic threshold for Grid appearanc
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
85.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
73.7kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ruflo
73.2k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
CowAgent
47.1kOpen-source super AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
