Book Marketing
jwynia/agent-skills
Diagnose book marketing copy problems and generate platform-optimized blurbs, descriptions, taglines, and query pitches.
Given a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences…
$ npx skills add Varnan-Tech/opendirectory --skill map-your-market -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Varnan-Tech/opendirectory map-your-market --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/map-your-market .claude/skills/map-your-market && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "map-your-market" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market into .claude/skills/map-your-market/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "map-your-market", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-marketType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Varnan-Tech/opendirectory --skill map-your-market -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Varnan-Tech/opendirectory map-your-market --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/map-your-market .agents/skills/map-your-market && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "map-your-market" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market into .agents/skills/map-your-market/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "map-your-market", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Varnan-Tech/opendirectory --skill map-your-market -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Varnan-Tech/opendirectory map-your-market --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/map-your-market .cursor/skills/map-your-market && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "map-your-market" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market into .cursor/skills/map-your-market/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "map-your-market", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Varnan-Tech/opendirectory.git --path skills/map-your-market--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Varnan-Tech/opendirectory --skill map-your-market -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Varnan-Tech/opendirectory map-your-market --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/map-your-market .gemini/skills/map-your-market && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "map-your-market" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market into .gemini/skills/map-your-market/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "map-your-market", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Varnan-Tech/opendirectory map-your-marketInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Varnan-Tech/opendirectory --skill map-your-market -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/map-your-market .github/skills/map-your-market && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "map-your-market" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market into .github/skills/map-your-market/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "map-your-market", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Varnan-Tech/opendirectory --skill map-your-market -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Varnan-Tech/opendirectory map-your-market --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Varnan-Tech/opendirectory.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/map-your-market .opencode/skills/map-your-market && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "map-your-market" agent skill from https://github.com/Varnan-Tech/opendirectory/tree/main/skills/map-your-market into .opencode/skills/map-your-market/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "map-your-market", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
map-your-marketGiven a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences…
Map Your Market is an agent skill from Varnan-Tech/opendirectory. Given a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences, then synthesizes everything into a positioning framework showing who your ICP is, what they say out loud, and exactly how to talk to them. Use when asked to understand a market, find ICP pain points, map competitors, build a positioning doc, find messaging angles, or answer who is my customer and what do they actually…
Its SKILL.md is about 4.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/icp-signals.md`). Compatibility notes: ["claude-code","gemini-cli","github-copilot"]
It sits in Writing & Content, covering Copywriting and Positioning and messaging. It works with GitHub and Reddit. The repository describes itself as: AI Agent Skills built for Founders who hate Marketing. The licence is MIT.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 62e437a. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
GITHUB_TOKENFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
["claude-code","gemini-cli","github-copilot"]
From compatibility in the SKILL.md frontmatter.
Map Your Market loads about 4.3k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 195 tokens; SKILL.md has 818 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from Varnan-Tech/opendirectory at commit 62e437a, republished under its MIT licence (© Varnan-Tech). 818 words, ~4,279 tokens.
.claude/skills/map-your-market/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.Take a product description, category keywords, or competitor names. Search Reddit, HN, GitHub Issues, G2, and Google Trends for real pain signals. Score and cluster them. Build a complete positioning framework: ICP definition, ranked pain themes with verbatim quotes, market size signals, and messaging angles derived from actual language people use.
Critical rule: Every pain quote in the output must exist verbatim in the raw data collected by the script. Every vendor name in the market map must come from G2 scrape results or GitHub search results. Market size must say "signals suggest" -- never estimate a dollar figure from thin proxies. If a source returns 0 results, report 0 -- do not supplement with invented examples.
| The agent will want to... | Why that's wrong |
|---|---|
| Invent pain points or market size numbers | Every pain quote must be verbatim from raw data. Market size must cite signals found. Never estimate "typical" market size. |
| Score by post count instead of pain_score | A post with 2,000 upvotes about pricing is stronger than 50 posts with 10 upvotes each. Use the pain_score formula from references/pain-scoring.md. |
| Use the same subreddits for every category | r/politics adds noise to a devops search. Auto-detect relevant subreddits from the category and competitor names before searching. |
| Send all raw signals to AI without scoring | Score locally first. Send only the top 60 high-pain-score signals to AI clustering. Saves tokens and improves cluster quality. |
| Skip ICP extraction from post metadata | Subreddit, flair, author bio (HN), and GitHub org type are richer ICP signals than post content. Always capture and report them. |
| Conflate vendor count with market size | "47 vendors on G2" means competitive, not large. Present all signals as directional indicators, not hard numbers. |
echo "GITHUB_TOKEN: ${GITHUB_TOKEN:-not set -- GitHub Issues search runs at 60 req/hr unauthenticated}"
echo "No other API keys required."
echo ""
echo "Data sources this run will use:"
echo " Reddit public JSON (no auth, 10 req/min)"
echo " HN Algolia API (no auth, free)"
echo " GitHub Issues API (${GITHUB_TOKEN:+authenticated, }60-5000 req/hr)"
echo " G2 category scrape (no auth, HTML parse)"
echo " Google Trends (no auth, unofficial endpoint)"If GITHUB_TOKEN is not set: continue. Unauthenticated GitHub search is 60 req/hr -- enough for a standard run. For repeated use, add a token at github.com/settings/tokens (no scopes needed for public repos).
Collect from the conversation:
category -- keyword(s) describing the market space (e.g. "developer observability", "B2B analytics", "devops tooling")competitors -- optional list of competitor product names or domains (e.g. "Datadog, New Relic, Grafana")product_context -- optional: what the user's product does (helps tailor messaging angles)If the user provides only a product description with no category keyword: extract 2-3 category keywords from it yourself.
If the user provides only competitor names with no category: infer the category by looking up competitors.
Write the parsed input:
python3 << 'PYEOF'
import json, os
data = {
"category": "CATEGORY_HERE",
"competitors": ["COMP_1", "COMP_2"],
"product_context": "PRODUCT_CONTEXT_HERE"
}
with open("/tmp/mym-input.json", "w") as f:
json.dump(data, f, indent=2)
print("Input written to /tmp/mym-input.json")
print(f"Category: {data['category']}")
print(f"Competitors: {', '.join(data['competitors']) if data['competitors'] else 'none provided'}")
PYEOFThe script handles all data collection. Check if it exists first:
ls scripts/fetch.py 2>/dev/null && echo "script available" || echo "not found"If available, run it:
GITHUB_TOKEN="${GITHUB_TOKEN:-}" python3 scripts/fetch.py \
"$(python3 -c "import json; d=json.load(open('/tmp/mym-input.json')); print(d['category'])")" \
--competitors "$(python3 -c "import json; d=json.load(open('/tmp/mym-input.json')); print(','.join(d['competitors']))")" \
--context "$(python3 -c "import json; d=json.load(open('/tmp/mym-input.json')); print(d['product_context'])")" \
--output /tmp/mym-raw.jsonWait for completion (allow up to 4 minutes -- Reddit + HN searches take ~90 seconds total).
Verify output:
python3 -c "
import json
with open('/tmp/mym-raw.json') as f:
d = json.load(f)
print(f'Reddit signals: {d[\"market_signals\"][\"reddit_signals_found\"]}')
print(f'HN signals: {d[\"market_signals\"][\"hn_signals_found\"]}')
print(f'GitHub signals: {d[\"market_signals\"][\"github_issue_signals\"]}')
print(f'G2 vendors: {d[\"market_signals\"][\"vendor_count_g2\"]}')
print(f'Trends: {d[\"market_signals\"][\"trends_direction\"]}')
print(f'Total signals: {d[\"summary\"][\"total_pain_signals\"]}')
"If total signals < 10: stop. Tell the user: "Fewer than 10 pain signals found for this category. The market may be too niche for Reddit/HN coverage, or the category keywords need adjustment. Try broader keywords or add competitor names."
Print the top 60 pain signals for AI analysis:
python3 -c "
import json
with open('/tmp/mym-raw.json') as f:
d = json.load(f)
top60 = sorted(d['raw_pains'], key=lambda x: x['pain_score'], reverse=True)[:60]
print(json.dumps(top60, indent=2))
"You now have the top 60 pain signals. Analyze them and produce pain clusters.
Instructions for AI analysis:
Write the clusters to /tmp/mym-clusters.json:
{
"clusters": [
{
"theme": "exact language from the data",
"total_score": 847,
"signal_count": 34,
"sources": {"reddit": 18, "hn": 12, "github_issue": 4},
"top_subreddits": ["devops", "sysadmin"],
"verbatim_quotes": [
{"text": "exact quote", "source": "reddit", "score": 234, "url": "..."},
{"text": "exact quote", "source": "hn", "score": 87, "url": "..."}
],
"who_has_this_pain": "description of who is posting about this"
}
]
}python3 -c "
import json, os
# Confirm clusters file was written
with open('/tmp/mym-clusters.json') as f:
d = json.load(f)
print(f'Clusters written: {len(d[\"clusters\"])}')
for c in d['clusters']:
print(f' {c[\"theme\"]} -- score: {c[\"total_score\"]}, signals: {c[\"signal_count\"]}')
"Print the ICP signals from the raw data:
python3 -c "
import json
with open('/tmp/mym-raw.json') as f:
d = json.load(f)
print('ICP signals:')
print(json.dumps(d['icp_signals'], indent=2))
print()
print('Subreddit distribution:')
sub_counts = {}
for p in d['raw_pains']:
s = p.get('subreddit', '')
if s:
sub_counts[s] = sub_counts.get(s, 0) + 1
for sub, count in sorted(sub_counts.items(), key=lambda x: -x[1])[:10]:
print(f' r/{sub}: {count} signals')
"Using the ICP signals and subreddit distribution above, synthesize the ICP profile. Write it to /tmp/mym-clusters.json by adding an icp key:
{
"icp": {
"who_they_are": "2-3 sentence profile using language from the data",
"where_they_live": ["r/devops (89 posts)", "r/sysadmin (67 posts)", "HN ask-hn (34 threads)"],
"what_they_say": ["verbatim quote 1", "verbatim quote 2", "verbatim quote 3"],
"what_they_have_tried": ["alternative tools or approaches mentioned in the data"],
"confidence": "high|medium|low -- based on signal volume and source diversity"
}
}Print the market signals:
python3 -c "
import json
with open('/tmp/mym-raw.json') as f:
d = json.load(f)
ms = d['market_signals']
print('Market signals:')
print(f' G2 vendors: {ms[\"vendor_count_g2\"]}')
print(f' Trends direction: {ms[\"trends_direction\"]}')
print(f' HN signals (12mo): {ms[\"hn_signals_found\"]}')
print(f' Reddit signals: {ms[\"reddit_signals_found\"]}')
print(f' G2 top vendors: {json.dumps(ms.get(\"top_vendors\", []), indent=4)}')
"Synthesize a directional market size assessment using only these signals. Do not estimate a dollar figure. Use language like:
Add the assessment to /tmp/mym-clusters.json as a market_size key.
Using the clusters (Step 4), ICP (Step 5), and market size (Step 6), generate the positioning framework.
Instructions:
Write the full positioning framework to /tmp/mym-output.json:
{
"positioning_angles": [
{
"pain": "theme name",
"statement": "one-line positioning using market language",
"headline": "landing page headline using verbatim pain language",
"cold_email_subject": "subject line"
}
],
"icp_card": {
"one_liner": "one sentence: who they are + what they care about",
"where_to_find_them": [...],
"how_to_talk_to_them": "tone + vocabulary notes from the data"
},
"market_map": [...top vendors from G2 with positioning notes...]
}Run self-QA checks:
python3 -c "
import json
# Load all outputs
with open('/tmp/mym-raw.json') as f:
raw = json.load(f)
with open('/tmp/mym-clusters.json') as f:
clusters = json.load(f)
with open('/tmp/mym-output.json') as f:
output = json.load(f)
raw_texts = set()
for p in raw['raw_pains']:
raw_texts.add(p.get('title', ''))
raw_texts.add(p.get('body_excerpt', ''))
# Check 1: No em dashes
import json as j
full_text = j.dumps(output)
if '—' in full_text:
print('FAIL: em dash found in output')
else:
print('PASS: no em dashes')
# Check 2: No banned words
banned = ['powerful', 'robust', 'seamless', 'innovative', 'game-changing',
'streamline', 'leverage', 'transform', 'revolutionize']
found = [w for w in banned if w.lower() in full_text.lower()]
if found:
print(f'FAIL: banned words found: {found}')
else:
print('PASS: no banned words')
# Check 3: Market size language check
if 'billion' in full_text.lower() or 'trillion' in full_text.lower() or 'worth \$' in full_text.lower():
print('FAIL: hard market size estimate found -- use directional language only')
else:
print('PASS: no hard market size estimates')
# Check 4: Signal counts match
total = raw['summary']['total_pain_signals']
print(f'PASS: {total} total pain signals in raw data')
print('Self-QA complete.')
"Fix any failures before saving.
Save the final report:
python3 << 'PYEOF'
import json, re
from datetime import datetime
with open('/tmp/mym-input.json') as f:
inp = json.load(f)
with open('/tmp/mym-raw.json') as f:
raw = json.load(f)
with open('/tmp/mym-clusters.json') as f:
clusters = json.load(f)
with open('/tmp/mym-output.json') as f:
output = json.load(f)
slug = re.sub(r'[^a-z0-9]+', '-', inp['category'].lower()).strip('-')
date = datetime.now().strftime('%Y-%m-%d')
outpath_md = f"docs/market-maps/{slug}-{date}.md"
outpath_json = f"docs/market-maps/{slug}-{date}.json"
# Build markdown report
ms = raw['market_signals']
icp = clusters.get('icp', {})
market_assessment = clusters.get('market_size', {})
angles = output.get('positioning_angles', [])
icp_card = output.get('icp_card', {})
market_map = output.get('market_map', [])
lines = [
f"# Market Map: {inp['category'].title()}",
f"Date: {date} | Signals analyzed: {raw['summary']['total_pain_signals']} | Sources: Reddit ({ms['reddit_signals_found']}) + HN ({ms['hn_signals_found']}) + GitHub Issues ({ms['github_issue_signals']})",
"",
"---",
"",
"## Market Size Signals",
f"Vendors on G2: {ms['vendor_count_g2']} | Google Trends: {ms['trends_direction'].upper()} | Market stage: {market_assessment.get('stage', 'see signals below')}",
"",
market_assessment.get('summary', ''),
"",
"---",
"",
"## Your ICP",
"",
f"**Who they are:** {icp.get('who_they_are', '')}",
"",
f"**Where they live:** {', '.join(icp.get('where_they_live', []))}",
"",
"**What they say:**",
]
for q in icp.get('what_they_say', []):
lines.append(f'> "{q}"')
lines += ["", "---", "", "## Top Pains (ranked by signal strength)", ""]
for i, c in enumerate(clusters.get('clusters', []), 1):
lines.append(f"### Pain {i}: {c['theme']} [score: {c['total_score']}]")
sources = c.get('sources', {})
source_str = " + ".join(f"{src} ({cnt})" for src, cnt in sources.items())
lines.append(f"{c['signal_count']} signals | Sources: {source_str}")
lines.append(f"Who has this pain: {c.get('who_has_this_pain', '')}")
lines.append("")
lines.append("Verbatim:")
for q in c.get('verbatim_quotes', [])[:4]:
lines.append(f'> "{q[\"text\"]}" ({q["source"]}, score: {q["score"]})')
lines.append("")
lines += ["---", "", "## Market Map (Key Players)", ""]
if market_map:
lines.append("| Vendor | Positioning |")
lines.append("|---|---|")
for v in market_map:
lines.append(f"| {v.get('name','')} | {v.get('positioning','')} |")
else:
top = ms.get('top_vendors', [])
if top:
lines.append("| Vendor | G2 Reviews | Rating |")
lines.append("|---|---|---|")
for v in top:
lines.append(f"| {v.get('name','')} | {v.get('review_count','')} | {v.get('rating','')} |")
lines += ["", "---", "", "## Messaging Framework", ""]
for a in angles:
lines.append(f"**{a['pain']}:** {a['statement']}")
lines.append(f"Headline: \"{a['headline']}\"")
lines.append(f"Cold email subject: \"{a['cold_email_subject']}\"")
lines.append("")
lines += ["---", "", "## ICP Card", "",
f"**One liner:** {icp_card.get('one_liner', '')}",
"",
f"**Find them at:** {', '.join(icp_card.get('where_to_find_them', []))}",
"",
f"**How to talk to them:** {icp_card.get('how_to_talk_to_them', '')}",
"",
"---",
"",
"## Data Quality Notes",
f"- All pain quotes are verbatim from raw signals",
f"- All vendor names from G2 scrape",
f"- Market size is directional only (no dollar estimates)",
f"- Sources: Reddit ({ms['reddit_signals_found']}), HN ({ms['hn_signals_found']}), GitHub Issues ({ms['github_issue_signals']}), G2 ({ms['vendor_count_g2']} vendors)",
"",
f"Saved to: {outpath_md}",
f"JSON snapshot: {outpath_json}",
]
with open(outpath_md, 'w') as f:
f.write('\n'.join(lines))
# Save JSON snapshot
snapshot = {"input": inp, "market_signals": ms, "clusters": clusters.get('clusters', []),
"icp": icp, "market_size": market_assessment, "positioning": output, "date": date}
with open(outpath_json, 'w') as f:
json.dump(snapshot, f, indent=2)
print(f"Report saved: {outpath_md}")
print(f"JSON snapshot: {outpath_json}")
PYEOFClean up temp files:
rm -f /tmp/mym-input.json /tmp/mym-raw.json /tmp/mym-clusters.json /tmp/mym-output.json
echo "Done. Market map saved to docs/market-maps/"Present the full contents of the saved .md file to the user.
© Varnan-Tech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 7 other files (scripts, references) in skills/map-your-market of Varnan-Tech/opendirectory.
Open the folder on GitHubat commit 62e437a
Map Your Market next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Map Your Market this skillVarnan-Tech/opendirectory | 674 | — | ~4.3k | Automated safety check: Pass | MIT | |
| Book Marketingjwynia/agent-skills | 169 | — | ~4.2k | Automated safety check: Pass | MIT | |
| Marketingericrisco/rsc-harness | 174 | — | ~3.7k | Automated safety check: Pass | MIT | |
| Reddit CommentsInfrasity-Labs/dev-gtm-claude-skills | 139 | — | ~2.5k | Automated safety check: Pass | MIT | |
| Launch ItAIDevGTM/gtm-cofounder | 312 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Metadata Checkjdevalk/skills | 105 | — | ~1k | Automated safety check: Pass | MIT |
jwynia/agent-skills
Diagnose book marketing copy problems and generate platform-optimized blurbs, descriptions, taglines, and query pitches.
ericrisco/rsc-harness
A skill your agent uses when the words span a marketing surface — value proposition, section copy, microcopy, launch and email sequences, channel adaptation, SEO-aware structure — grounded in the…
Infrasity-Labs/dev-gtm-claude-skills
Draft, review, and refactor Reddit comments for any company by providing a domain URL and a Reddit thread.
AIDevGTM/gtm-cofounder
Plan a developer launch (Show HN, Reddit, Product Hunt) that earns goodwill instead of a flaming.
jdevalk/skills
Reviews short high-value strings — page titles, meta descriptions, schema description fields, FAQ answers, GitHub repo taglines, profile bios, social-card copy, and other metadata where Flesch and…
affaan-m/ECC
End-to-end marketing campaign planning and execution. An agent skill from affaan-m/ECC.
Varnan-Tech/opendirectory
Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF.
Varnan-Tech/opendirectory
Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture.
Varnan-Tech/opendirectory
Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6.
Varnan-Tech/opendirectory
Creates animated looping GIFs from CSS animations (default) or AI image-to-video.
Varnan-Tech/opendirectory
Aggregates RSS feeds from the past week, synthesizes the top stories using Gemini, and publishes a newsletter digest to Ghost CMS.
Varnan-Tech/opendirectory
A skill your agent uses when fetching, searching, or analyzing transcripts from Lenny's Podcast, Dwarkesh Podcast, Cheeky Pint, 20VC, or A16z Podcast.
Categories
Given a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences…. Map Your Market is an agent skill from Varnan-Tech/opendirectory. Given a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences, then synthesizes everything into a positioning framework showing who your ICP is, what they say out loud, and exactly how to talk to them.
Map Your Market fits situations like: asked to understand a market; find ICP pain points; map competitors; build a positioning doc.
Run `npx skills add Varnan-Tech/opendirectory --skill map-your-market -a claude-code`. Or copy the skill folder (skills/map-your-market in Varnan-Tech/opendirectory) into .claude/skills/map-your-market in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Varnan-Tech/opendirectory --skill map-your-market -a codex`. Or copy the skill folder (skills/map-your-market in Varnan-Tech/opendirectory) into .agents/skills/map-your-market in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Varnan-Tech/opendirectory --skill map-your-market -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/map-your-market, .gemini/skills/map-your-market, .github/skills/map-your-market and .opencode/skills/map-your-market in your project.
Going by SKILL.md and its folder, Map Your Market needs Python for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named GITHUB_TOKEN. Our summary lists: Python 3; A credential in GITHUB_TOKEN. Compatibility (from SKILL.md): ["claude-code","gemini-cli","github-copilot"].
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Map Your Market is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 4.3k tokens (SKILL.md is roughly 17k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.1k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Map Your Market: Book Marketing (jwynia/agent-skills, 169 stars), Marketing (ericrisco/rsc-harness, 174 stars), Reddit Comments (Infrasity-Labs/dev-gtm-claude-skills, 139 stars) and Launch It (AIDevGTM/gtm-cofounder, 312 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Varnan-Tech (a GitHub organization) maintains it in Varnan-Tech/opendirectory, which has 674 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on August 16, 2026.
Source: Varnan-Tech/opendirectory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.