submit-program skill
✓ VerifiedResearch affiliate programs from official sources to create verified, publish-ready listings and commission profiles.
- GitHub stars
- 779
- Files
- 1
- Last commit
- Oct 19, 2026
- License
- MIT
- Allowed tools
- —
What does the submit-program skill do?
submit-program is an agent skill. Research affiliate programs from official sources to create verified, publish-ready listings and commission profiles.
Summary generated from the skill's SKILL.md.
About the submit-program skill
Creating verified, publish-ready affiliate program listings is what this skill enables for marketers and directory contributors. It automates the research process by searching official affiliate pages, network listings, and pricing pages to extract accurate commission structures, cookie durations, and payment terms. This ensures that every data point, such as reward types or payout frequencies, is grounded in official documentation rather than guesswork.
An agent should load this skill when a user needs to document a program, add a new entry to the openaffiliate.dev directory, or build a shareable profile for an affiliate program. The skill produces structured listing fields and a detailed markdown description that includes commission tables, target audience analysis, and realistic earning potential calculations. It is designed to work with various AI clients to transform raw program names into professional, community-ready contributions.
What an agent can do with it
- 1Add a program to a directoryA user wants to contribute a new affiliate program to the openaffiliate.dev community directory.
- 2Document commission structuresAn agent can be tasked with creating a standardized document of a program's specific commission rates and tiers.
- 3Generate affiliate marketing profilesCreate a comprehensive, shareable profile that helps other affiliates understand the value of promoting a specific product.
- 4Calculate realistic earningsDevelop a projection of monthly and annual earnings based on conservative traffic and conversion assumptions.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the submit-program skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the submit-program skill in Claude Code
~/.claude/skills/submit-program/SKILL.md
$ npx degit Affitor/affiliate-skills/skills/research/submit-program ~/.claude/skills/submit-programInstall the submit-program skill in Claude Code (project)
.claude/skills/submit-program/SKILL.md
$ npx degit Affitor/affiliate-skills/skills/research/submit-program .claude/skills/submit-programInstall the submit-program skill in Codex
~/.agents/skills/submit-program/SKILL.md
$ npx degit Affitor/affiliate-skills/skills/research/submit-program ~/.agents/skills/submit-programInstall the submit-program skill in Gemini CLI
~/.gemini/skills/submit-program/SKILL.md
$ npx degit Affitor/affiliate-skills/skills/research/submit-program ~/.gemini/skills/submit-programInstall the submit-program skill in Claude.ai
npx degit Affitor/affiliate-skills/skills/research/submit-program submit-program && zip -r submit-program.zip submit-program # claude.ai → Customize → Skills → + → Create skill → Upload a skill → submit-program.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachableaffitor/affiliate-skills/skills/research/submit-program is public and reachablegithub.com/affitor/affiliate-skills/tree/HEAD/skills/researc ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-10-19github.com/affitor/affiliate-skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/affitor/affiliate-skills/blob/HEAD/skills/researc ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/affitor/affiliate-skills/blob/HEAD/skills/researc ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 403 linesgithub.com/affitor/affiliate-skills/blob/HEAD/skills/researc ↗Pass
SKILL.md
View on GitHubAffiliate Program Lister
Research an affiliate program from official sources and produce a verified, publish-ready listing for openaffiliate.dev. Every number comes from the program's official affiliate page, network page, or pricing page. No guessing.
Stage
This skill belongs to Stage S1: Research
When to Use
- User wants to add an affiliate program to openaffiliate.dev
- User wants to document a program's commission structure in a standard format
- User found a program and wants to create a shareable profile for other affiliates
- User is contributing to the community directory
- User says "list this program" or "add X to the directory"
Input Schema
{
program_name: string # (required) Name of the affiliate program, e.g., "HeyGen"
affiliate_link: string # (optional) User's affiliate link to include in the listing
niche: string # (optional) Category hint, e.g., "AI video", "email marketing"
}
Workflow
Step 1: Confirm Program and Context
Confirm the program name with the user. Ask:
- Do you have an affiliate link for this program? (optional — used for verification only)
- What niche or category does it fall under? (helps with tagging)
If the user says "just list it" or provides enough context, skip questions and proceed.
Step 2: Research from Official Sources
Research the program using only official, verifiable sources. Search in this order:
-
Official affiliate/partner page —
web_search "[program name] affiliate program"orweb_search "[program name] partner program". This is the primary source for commission structure, cookie duration, payment terms, and signup link. -
Affiliate network page — If the program runs through a network (ShareASale, CJ, Impact, PartnerStack, Rewardful, etc.), find the network listing for additional details.
-
Official pricing page —
web_search "[program name] pricing". Needed to calculate realistic earnings (commission % means nothing without knowing the price). -
Credibility signals — Look for: number of customers, notable clients, funding raised, year founded, G2/Capterra rating, social proof. These go in the description.
For each data point, note the source. If a value cannot be verified from official sources, mark it as "unverified" in the output.
Step 3: Extract Listing Fields
Fill in the structured listing fields from the research:
| Field | Source | Notes |
|---|---|---|
name |
Official product name | Exact capitalization from their website |
url |
Product homepage | Main website, not affiliate signup page |
reward_type |
Affiliate page | One of: cpc, cpl, cps_one_time, cps_recurring, cps_lifetime, other |
reward_value |
Affiliate page | e.g., "30%", "$50", "$0.10 per click" |
reward_duration |
Affiliate page | For recurring: "12 months", "lifetime", etc. Omit for one-time |
cookie_days |
Affiliate page | Number only. If not stated, mark "unverified" and estimate from network norms |
tags |
Niche + features | 3-6 lowercase tags, e.g., ["ai", "video", "saas"] |
Reward type mapping:
- "X% of each sale" (one purchase) →
cps_one_time - "X% recurring" or "X% for Y months" →
cps_recurring - "X% for life of customer" →
cps_lifetime - "Pay per lead / free trial signup" →
cpl - "Pay per click" →
cpc - Anything else →
other(explain in description)
Step 4: Write the Description
The description is structured markdown that helps affiliates decide if the program is worth promoting. Write these sections in order:
Opening (2-3 sentences) What the product does, who it serves, and why affiliates should care. Lead with the value proposition, not the company history.
Why Promote This Program 3-5 bullet points covering: commission rate highlights, cookie duration, payment reliability, product-market fit, conversion-friendly features (free trial, demo, low friction signup).
Commission Structure A markdown table with all commission tiers if multiple exist:
| Plan | Price | Commission | Per Sale | Type |
|------|-------|-----------|----------|------|
| Starter | $29/mo | 30% | $8.70/mo | Recurring |
| Pro | $89/mo | 30% | $26.70/mo | Recurring |
| Enterprise | Custom | 30% | Varies | Recurring |
Include: minimum payout threshold, payment methods (PayPal, wire, etc.), payment frequency (monthly, net-30, etc.) if found.
Target Audiences Who can promote this product effectively. List 3-5 specific audience types with brief reasoning, e.g., "YouTube creators making tutorial content — visual product, easy to demo."
Earning Potential Realistic earnings at three traffic levels using conservative conversion assumptions (2% CTR, 2% conversion rate):
| Monthly Traffic | Est. Sales | Monthly Earnings | Annual Earnings |
|----------------|-----------|-----------------|----------------|
| 5,000 visitors | 2 | $X | $X |
| 20,000 visitors | 8 | $X | $X |
| 100,000 visitors | 40 | $X | $X |
For recurring programs, show month-12 compounded earnings, not just month-1.
Why It Converts 2-3 sentences on what makes this product easy to sell: free tier, strong brand recognition, low-commitment entry point, visual demo potential, etc.
Honest Limitations 2-3 bullet points on real drawbacks. Every program has them. Examples: short cookie window, high competition from other affiliates, niche audience only, high price point limits conversions, payout threshold too high for beginners.
Step 5: Verify Affiliate Link (If Provided)
If the user provided an affiliate link:
- Check that the domain matches the program's known affiliate tracking domain
- Check for expected URL parameters (ref=, aff=, via=, etc.)
- Flag if the link looks malformed or suspicious
- Do NOT click the link or test it — just validate the format
Step 6: Assemble Output
Present the output in two clearly separated parts:
- Listing Fields — structured data ready for API submission
- Description — the full markdown content
Step 7: Optional API Submission
If the user wants to submit the listing directly, note that openaffiliate.dev is a community-curated directory. Submissions are made via GitHub pull request to the Affitor/affiliate-skills repository. Format the listing fields below so the user can include them in a PR or share via the community.
{
"name": "...",
"url": "...",
"description": "...",
"reward_type": "...",
"reward_value": "...",
"reward_duration": "...",
"cookie_days": 30,
"tags": ["...", "..."]
}
Step 8: Self-Validation
Before presenting output, verify:
-
namematches official product name (exact capitalization) -
reward_valuecomes from the official affiliate page, not estimated -
reward_typeuses one of the allowed enum values -
cookie_daysis a number from official source or explicitly marked "unverified" - Commission table math is correct (price x percentage = per-sale amount)
- Earning potential uses conservative assumptions (2% CTR, 2% CR) not optimistic ones
- Honest Limitations section contains real drawbacks, not filler
- No data was hallucinated — every number traces to a source
If any check fails, fix the output before delivering. Do not flag the checklist to the user — just ensure the output passes.
Output Schema
Other skills consume these fields from conversation context:
{
output_schema_version: "1.0.0" # Semver — bump major on breaking changes
listing: {
name: string # "HeyGen"
url: string # "https://heygen.com"
description: string # Full markdown description (all sections)
reward_type: string # "cps_recurring" — enum: cpc, cpl, cps_one_time, cps_recurring, cps_lifetime, other
reward_value: string # "30%" or "$50"
reward_duration: string # "12 months" | "lifetime" | null (for one-time)
cookie_days: number # 60
tags: string[] # ["ai", "video", "saas"]
}
sources: {
affiliate_page: string # URL of official affiliate page
pricing_page: string # URL of pricing page
network: string | null # "PartnerStack", "ShareASale", etc.
}
verification: {
all_fields_verified: boolean # true if every field from official source
unverified_fields: string[] # ["cookie_days"] if any field could not be confirmed
}
}
Output Format
## Listing Fields
| Field | Value |
|-------|-------|
| Name | [Product Name] |
| URL | [https://product.com] |
| Reward Type | [cps_recurring] |
| Reward Value | [30%] |
| Reward Duration | [12 months] |
| Cookie Days | [60] |
| Tags | [ai, video, saas] |
**Sources:** Affiliate page: [URL] | Pricing page: [URL] | Network: [Name or "Direct"]
---
## Description
[Opening paragraph]
### Why Promote This Program
- [Bullet 1]
- [Bullet 2]
- [Bullet 3]
### Commission Structure
| Plan | Price | Commission | Per Sale | Type |
|------|-------|-----------|----------|------|
| ... | ... | ... | ... | ... |
Payment: [method], [frequency], [minimum payout]
### Target Audiences
- **[Audience 1]** — [why they can promote this]
- **[Audience 2]** — [why they can promote this]
- **[Audience 3]** — [why they can promote this]
### Earning Potential
| Monthly Traffic | Est. Sales | Monthly Earnings | Annual Earnings |
|----------------|-----------|-----------------|----------------|
| 5,000 visitors | [X] | $[X] | $[X] |
| 20,000 visitors | [X] | $[X] | $[X] |
| 100,000 visitors | [X] | $[X] | $[X] |
*Assumes 2% CTR, 2% conversion rate. [Recurring note if applicable.]*
### Why It Converts
[2-3 sentences]
### Honest Limitations
- [Limitation 1]
- [Limitation 2]
- [Limitation 3]
---
**Ready to share?** Copy the Listing Fields above and submit via a GitHub PR to
Affitor/affiliate-skills, or browse the directory at openaffiliate.dev.
Error Handling
- Program has no affiliate program: Tell the user clearly. Suggest checking back later or searching for similar programs that do offer affiliates. Do not fabricate commission data.
- Affiliate page is behind a login wall: Note that commission details could not be verified from public sources. Use network listing or trusted third-party sources as fallback. Mark unverified fields explicitly.
- Data is unclear or conflicting: When sources disagree (e.g., affiliate page says 20% but network says 25%), note both values and flag the discrepancy. Let the user decide which to use.
- Program recently changed terms: If the affiliate page mentions "updated" or "new" commission rates, note the date if available and flag that terms may change.
- Pricing is usage-based or custom: Use the most common plan tier for earning calculations. Note the assumption. For enterprise-only pricing, use "Contact sales" and skip per-sale calculations for that tier.
- Cookie duration not stated: Mark as "unverified" and note the network default (ShareASale: typically 30d, Impact: varies, PartnerStack: typically 90d). Do not guess.
Examples
Example 1: SaaS with recurring commission User: "List HeyGen's affiliate program"
- Search official affiliate page → 30% recurring, 60-day cookie, via PartnerStack
- Pricing page → Creator $29/mo, Business $89/mo, Enterprise custom
- Build commission table: Creator = $8.70/mo, Business = $26.70/mo
- Earning potential at 5K visitors: ~2 sales/mo = $17-53/mo (month 1), compounding
- Tags: ai, video, saas, content-creation
- Limitations: competitive niche, product requires learning curve
Example 2: One-time commission program User: "Add Bluehost affiliate program to the list"
- Search → $65+ per signup (one-time), 90-day cookie, direct program
- Pricing → Basic $2.95/mo, Plus $5.45/mo, Choice Plus $5.45/mo
- reward_type: cps_one_time, reward_value: "$65+"
- Earning potential: straightforward per-sale math, no compounding
- Tags: hosting, wordpress, web-hosting, beginner-friendly
- Limitations: saturated market, aggressive competitor affiliates, low-margin hosting
Example 3: Program with unverifiable data User: "Create a listing for this new AI tool I found — ToolXYZ"
- Search affiliate page → behind login, cannot verify commission
- Network listing found on ShareASale → 15% recurring, cookie not specified
- Mark cookie_days as "unverified", note ShareASale default is typically 30 days
- Pricing page → $19/mo and $49/mo plans
- Flag in output: "Commission verified via ShareASale listing. Cookie duration unverified."
- Proceed with listing, clearly marking unverified fields
Flywheel Connections
Feeds Into
affiliate-blog-builder(S3) — listing data powers review articles and roundup postslanding-page-creator(S4) — commission structure and product details feed landing pagescomparison-post-writer(S3) — verified program data for side-by-side comparisonscommission-calculator(S1) — structured commission data for earnings projectionsviral-post-writer(S2) — program highlights for social contentbonus-stack-builder(S4) — product knowledge informs bonus design
Fed By
affiliate-program-search(S1) — discovered programs that need to be listedniche-opportunity-finder(S1) — high-opportunity niches with programs worth documentingconversion-tracker(S6) — top-performing programs worth listing for the community
Feedback Loop
- Community engagement on openaffiliate.dev (stars, comments) reveals which listing styles and description formats drive the most affiliate signups. High-star listings become templates for future listings. Low-engagement listings get revised with better earning potential data and more specific audience targeting.
chain_metadata:
skill_slug: "submit-program"
stage: "research"
timestamp: string
suggested_next:
- "affiliate-blog-builder"
- "comparison-post-writer"
- "landing-page-creator"
- "commission-calculator"
Quality Gate
Before marking this skill's output as complete:
- Every commission number traces to an official source URL
- The
reward_typeis a valid enum value from the openaffiliate.dev schema - Earning potential math is correct and uses conservative assumptions
- The description contains all required sections (Opening, Why Promote, Commission Table, Target Audiences, Earning Potential, Why It Converts, Honest Limitations)
- At least one real limitation is listed — no "this program is perfect" outputs
- Unverified fields are explicitly flagged, never silently estimated
- Tags are lowercase, 3-6 items, and relevant to the program's niche
References
affiliate-program-search/references/openaffiliate-api.md— API endpoints for openaffiliate.dev (public, no auth)shared/references/affiliate-glossary.md— reward_type definitions and field namesshared/references/flywheel-connections.md— master flywheel connection map
Files in this skill
1submit-program skill questions
How do I install the submit-program skill in Claude Code?
Run npx degit Affitor/affiliate-skills/skills/research/submit-program ~/.claude/skills/submit-program. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the submit-program skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What sources are used to verify affiliate program data?
The skill uses official affiliate/partner pages, affiliate network pages (like ShareASale or Impact), and official pricing pages to ensure accuracy.
How is earning potential calculated in the listing?
Earning potential is calculated using conservative assumptions of a 2% click-through rate (CTR) and a 2% conversion rate.
Can I submit the created listing directly to the directory?
Submissions to openaffiliate.dev are made via GitHub pull requests to the Affitor/affiliate-skills repository.