jasoncolapietro/suede-directory-submissions
Suede-affiliated directory distribution strategy for selecting listings, sequencing submissions, tailoring positioning, and verifying backlinks. Use when a product needs startup, SaaS, AI, MCP, marketplace, or review-directory submissions and a measurable tracker. NOT FOR: broader launch orchestration (use suede-launch-packaging), scalable destination-page production (use suede-programmatic-seo), or citation and search auditing (use suede-seo-audit).
npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-directory-submissions
Suede treats directory distribution as a verifiable discovery layer, not a submission-count contest. Build the user's backlink and buyer-discovery foundation by selecting the right directories, sequencing them around real launch moments, adapting truthful positioning, and checking that each listing and backlink actually landed.
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.
Directory submissions can add discovery surfaces, referral paths, and backlinks, but
their value varies by product, directory, listing quality, and current platform
rules. Treat each benefit as a hypothesis to verify with listing status, referral
analytics, search data, and qualified outcomes. A directory plan complements
destination pages and other distribution; it does not guarantee authority,
citation, traffic, ranking, or leads.
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.
Before recommending a submission, verify the directory's current official
requirements and record the source URL and check date. The linked page should be
publicly reachable, truthful, useful to the directory's audience, and measurable.
Prepare only the assets the current form requires, using real product screenshots
and approved brand files. Add pricing, legal pages, video, schema, or additional
formats when the product, jurisdiction, or verified directory rules call for them;
do not invent universal prerequisites.
Choose the most relevant verified destination for each audience: a homepage,
use-case page, integration page, comparison page, template, or documentation page.
It must accurately fulfill the listing promise and have a measurable next step.
Do not impose a fixed page count or block a suitable listing merely because an
unrelated content type does not exist.
Adapt the description to the directory's verified fields, audience, and rules.
Reuse approved facts, but change emphasis when that improves relevance; do not
claim that duplicate descriptions trigger a search or AI penalty without current
evidence. See references/positioning-variations.md for templates.
| 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 | Use only for a live compatible capability. |
| 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. |
Assess the selected directory against current requirements:
A missing current platform requirement, truthful destination, or submission
authority is a hard block for that directory. Other gaps are prioritization inputs,
not universal launch blockers.
Full catalog in references/directory-list.md. Summary:
| Tier | When | Illustrative candidates to verify |
|---|---|---|
| Flagship launch | Around a relevant launch | Product Hunt, BetaList, HN Show HN, Fazier, DevHunt |
| Startup/SaaS | Launch and rolling | AlternativeTo, SaaSHub, G2, Capterra, F6S |
| AI directories | If the product has a substantiated AI capability | TAAFT, Futurepedia, Toolify, Future Tools |
| Agent/MCP registries | If a live compatible integration exists | Glama, APITracker, LF MCP Registry |
| No-code directories | If the product genuinely serves that audience | NoCodeFinder, No Code MBA |
| Integration marketplaces | When the integration ships | The integration owner's official marketplace |
| Profiles and vertical directories | When audience and category fit | Relevant company profiles or industry-specific catalogs |
Triage rule: Only submit where the product is a genuine fit under the
platform's current eligibility and category rules.
For each tier, prep distinct variants from
references/positioning-variations.md only after inspecting the destination's
current form:
Keep facts consistent and approved. Adapt length and emphasis to each verified
form without inventing features, customers, outcomes, or platform support.
Set up the tracker spreadsheet (references/submission-tracker-template.csv).
Prioritize a small evidence-backed batch. Before any external submission, show
the exact public copy, assets, account, destination, timing, and maximum cost,
then get explicit approval for that submission. Approval for research or
another directory does not transfer.
Per submission:
maximum cost.
preview; re-approve the delta.
page HTML for rel, redirect, and destination behavior. Absence of rel in
response headers does not prove link attributes. Log the method and check date.
For any time-sensitive launch surface, research the platform before building the
plan. Use its current official help, submission form, and community rules; record
the URLs and check date. Do not present remembered algorithm behavior, ideal
launch times, asset dimensions, hunter effects, or engagement thresholds as facts.
required assets, and prohibited promotion.
a working destination CTA in the exact current form limits.
fabricate engagement, or message people without a legitimate relationship and
authorization.
Review directories can help buyers evaluate products, but eligibility, incentive,
moderation, badge, report, and paid-plan rules change. Before recommending a
campaign:
verified cost.
gate, pre-score, or script reviews.
and any incentive before outreach.
complaints. Set targets from the actual eligible pool and user goals.
Do not claim a badge threshold, report cutoff, ownership relationship, incentive
permission, plan price, or expected response rate unless it was verified from a
current authoritative source. A small customer base is a planning constraint, not
automatic proof that a listing is worthless.
Match each listing to the most useful truthful page available. A homepage can be
appropriate when it satisfies the audience and promise; a specialized page may be
better when evidence supports it.
Use when current customer or search evidence shows comparison intent:
/alternatives/[competitor-1]/alternatives/[competitor-2]/alternatives/[competitor-3]/alternatives/[competitor-4]Use verified features and prices, clearly state when each option fits, and add
FAQs or structured data only when appropriate and valid.
Critical: Be honest. Verify material competitor claims, date the comparison,
and correct it when facts change.
Create a dedicated ICP or use-case page when current demand and product evidence
justify one:
/for/[audience] — coaches, agencies, ecommerce, SaaS, consultants, etc./use-cases/[use-case] — lead qualification, onboarding, product recommendations, etc.Use when templates provide standalone value and product activation can be
measured:
/templates/[slug].traffic or revenue story.
Write honest, current roundups only when the team can research the category and
disclose its methodology. Include a useful set of alternatives rather than a
fixed count, and do not promise ranking or AI citation.
Create an integration page when the integration is live and the page helps users
understand setup, capabilities, and limits. Measure its results rather than
projecting another company's traffic.
Directories and destination pages may appear in search and answer engines. Treat
visibility as an observable outcome, not a guaranteed effect of authority scores
or markup.
Use authorized, currently callable tools or manual checks to sample relevant
queries. Record engine, account context, prompt, locale, date, result, and whether
the result is reproducible. Verify any tracking product and its cost before
recommending it.
Most directory submissions are episodic; community participation is ongoing.
Measure each as a separate source before combining funnel conclusions.
Read the current rules of each community before recommending or publishing a
link. Participate with relevant firsthand value, disclose affiliation, and use
promotion threads only when the current rules allow it. Membership counts and
recurring-thread availability are volatile; verify them if they affect selection.
Candidate formats include approved firsthand numbers, real screenshots, lessons,
and mini case studies. Test them under the community's current rules rather than
claiming a universal winning format.
Use the channel when the actual audience and account analytics support it.
Experiment with approved firsthand stories, original research, useful analysis,
and document formats. Set cadence from production capacity and observed response;
do not promise a lead share or engagement multiplier.
Share authorized technical lessons, decisions, and outcomes where they serve the
audience. Measure referral and search results; do not claim indexing or answer
engine effects in advance.
relevant launch milestone.
Cross-post only where current terms permit it and use a canonical URL when the
platform supports one. Verify the rendered link and referral results.
Set baselines and goals from the user's current analytics, eligible audience,
capacity, and launch objective. Do not use generic day-based forecasts.
| Metric | Baseline | User-approved goal | Source and check date |
|---|---:|---:|---|
| Listings submitted and live | | | |
| Verified referring links | | | |
| Directory referral sessions | | | |
| Qualified conversions by listing | | | |
| Review requests and published reviews | | | |
| Search or answer-engine observations | | | |
| Cost and team time | | | |
changes, platform notices, and observed listing issues.
10. Don't lie on comparison pages. Verify material claims and date the comparison.
11. Don't over-index on launch-day spike. The flywheel is templates + alternatives + reviews + ongoing content — not one day of PH.
12. Don't create or change company profiles without authority. When authorized, keep verified entity facts consistent.
When the user asks for a directory plan, return:
references/positioning-variations.md)references/submission-tracker-template.csvKeep the plan actionable. Every item should be something the user can do today.
suede-launch-packaging for the broader launch sequence.suede-programmatic-seo for destination pages and suede-seo-audit for search or citation checks.suede-competitors for comparison-page strategy and suede-content-strategy for editorial support.suede-free-tools for interactive destination assets and suede-community-marketing for community distribution.Take jasoncolapietro/suede-directory-submissions from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.