competitor-research
Skill14 starsChanged 34 days agoMITView on GitHub
Runs a competitor deep dive on a company or product and turns it into a claim-safe battlecard. Starts from the competitor's own sources (site, docs, pricing page, changelog, filings, job posts, app store listings), checks them against independent sources, and labels every claim VERIFIED, CORROBORATED, VENDOR-CLAIMED, INFERRED or UNKNOWN with a source and a date. Separates what they sell from what they actually deliver, pricing evidence from guesses, and real weaknesses from wishful ones, then writes what your team can say and must not say. Works with web search in Claude.ai or Claude Code. Use when someone says \"research my competitor\", \"competitor deep dive\", \"make a battlecard\", \"how does X compare to us\", \"what does X actually offer\", \"how do we position against X\" or \"what can we say about X\".
30 other projects use a version of this.
Adopted by
Most recently taken up by
- openlegion-ai/openlegiontheir own version, first seen Nov 8, 2026
- kostja94/marketing-skillstheir own version, first seen Nov 8, 2026
- matteotitta/repo-structure-agencytheir own version, first seen Nov 8, 2026
- Ntmib/jarvis-architecttheir own version, first seen Nov 1, 2026
- Founderwithabs/SOLIDSFORYOUtheir own version, first seen Oct 25, 2026
- tymoshenko-dmytro/marketing-agent-kittheir own version, first seen Oct 21, 2026
Used with
Projects with it also use tov-guidelines, icp-research and 7 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
matteotittaSkilltov-guidelines
Analyzes existing client content (website, blog, social, docs) to extract voice patterns, vocabulary preferences,
Also in 5 projects that use this
growthack88Skillicp-research
Scrapes case studies, testimonials, and solutions pages from a target website to build structured ICP documentation. Produces TAM analysis, firmographic segments, champion and economic buyer personas, use case mapping, customer proof points, and voice-of-customer synthesis with normalized attributes. Requires website URL as primary input. Upstream: recommended company-context. Downstream: feeds positioning, product-messaging, landing-page-copy, content-strategy, and outreach-emails.
Also in 5 projects that use this
matteotittaSkillexpert-pov
Extracts contrarian beliefs, market perspectives, and philosophical stances from founder interviews or questionnaire
Also in 3 projects that use this
dachi-jp3Skilllevel
表示レベル(auto / low / medium / high)を切り替える。
Also in 3 projects that use this
VercelSkillmessaging
Use when turning settled positioning into the lines other people will reuse: the message hierarchy, value propositions per audience, objection handling, and the proof behind each claim.
Also in 4 projects that use this
ai-agents-for-agencies-coachesSkillbrand-kit
Establish and enforce per-client brand fidelity using the DESIGN.md standard (google-labs-code/design.md). Use whenever starting work for a client, creating any ad/landing-page/creative, or when brand colors/fonts/spacing are needed. Auto-extracts a client's visual identity into a validated DESIGN.md, keeps a central registry, and feeds the tokens into image-studio (statics), fb-ad-video-studio (video), and landing pages. Triggers: "set up brand for <client>", "make a DESIGN.md", "match the client's brand", "what are their brand colors", "new client onboarding", any creative work that must be on-brand.
Also in 4 projects that use this
- +1 more from matteotitta
Other versions30 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 30
- kostja94/marketing-skills★ 1.1ksame name
- explorium-ai/gtm-skills★ 346same name
- hamzafarooq/claude-code-starter★ 145same name
- openlegion-ai/openlegion★ 130same name
- marcosmodly/marketing-skill★ 100same name
- matteotitta/claude-code-marketing-quickstart★ 70same name
- matteotitta/repo-structure-in-house★ 70same name
- matteotitta/genesys-skills★ 46same name
- smithjohn78390/smith--skills★ 41same name
- yangliu2060/smith--skills★ 40same name
20 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository63 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- board-advisorSkill
- bottleneck-removalSkill
- business-auditSkill
- business-starterSkill
- founder-independenceSkill
- hand-it-offSkill
- happy-customerSkill
- hiring-replacementSkill
- meeting-follow-upSkill
- monday-numbersSkill
- new-hireSkill
- no-meeting-mondaySkill
- obsidian-brainSkill
- ops-deskSkill
- safe-resaleSkill
- spreadsheet-dashboardSkill
- warm-leadSkill
- downloadable-asset-engineeringSkill
- html-to-pdfSkill
- linux-server-opsSkill
- precision-pdf-editingSkill
- repo-radarSkill
- secure-credentialsSkill
- security-auditorSkill
- best-timeSkill
- brand-deal-filterSkill
- comment-replySkill
- content-monthSkill
- daily-socialSkill
- dm-closerSkill
- idea-bankSkill
- marketing-teamSkill
- reel-ideationSkill
- reel-scorecardSkill
- trial-postSkill
- viral-breakdownSkill
- youtube-seoSkill
- caption-engineSkill
- content-multiplierSkill
- edit-styleSkill
- footage-ingestSkill
- longform-editSkill
- podcast-repurposeSkill
- raw-to-reelSkill
- ready-to-filmSkill
- reel-captionsSkill
- script-polishSkill
- thumbnail-generatorSkill
- use-local-whisperSkill
- conversion-funnel-auditingSkill
- llms-txtSkill
- seo-agentSkill
- website-designerSkill
- website-devSkill
- be-conciseSkill
- humanizerSkill
- launch-weekSkill
- linkedin-writerSkill
- newsletterSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. 0 are common, 13 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 22 edited versions we read keep these.
13
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 18
The competitor's name and website: If the name is common, also the product name or a URL so you research the right company.
- Distinctive: line 21
Optional: call notes, lost-deal reasons or a quote you received.
- Distinctive: line 27
Write down the research date, competitor, product in scope, your product and the decision.
- Distinctive: line 37
When a launch post says "early access" and a later product page presents it as standard, record both and mark plan entitlement as UNKNOWN.
- Distinctive: line 48
Keep separate questions separate: does the capability exist, which plan gets it, is it included or extra, and who does the setup.
- Distinctive: line 58
Never apply a benchmark of a different product to this competitor.
- Distinctive: line 76
Every claim gets exactly one label, a source and a date checked.
- Distinctive: line 89
When sources conflict, record both with dates.
- Distinctive: line 93
Never invent numbers. If a figure is not in a source, it is UNKNOWN.
- Distinctive: line 103
Before delivering, check: every battlecard line traces to an evidence ID.
- Distinctive: line 109
If a key page could not be loaded, the report says so instead of filling the gap.
- Distinctive: line 110
Not legal advice. Public claims about a named competitor can carry legal risk.
- Distinctive: line 111
No logging in under false pretences, scraping behind logins, or using confidential material someone should not have shared.
“Common” is measured: kept by at least 6 in 10 of the 22 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Competitor Research
Most competitor research is marketing copy with opinions on top, and a month later a prospect catches your rep repeating something untrue. This skill does the opposite: every claim has a label, a source and a date, and the battlecard only lets your team say what the evidence supports.
Example used throughout: you sell Acme Scheduling and want to know how to position against Example CRM, which just added a booking feature.
What it does
Maps what the competitor sells today from their own sources, checks it against sources they do not control, separates what they sell from what customers actually get, records pricing evidence (never guesses), infers who they target (labelled), finds weaknesses you can use without overclaiming, and writes a battlecard: what we can say, what we must not say, and what to ask the prospect.
What you need
- The competitor's name and website. If the name is common, also the product name or a URL so you research the right company.
- Your own product in one or two lines, and what decision this supports (a sales call, a pricing change, a launch, a board question).
- Web search. In Claude.ai, turn on web search. In Claude Code, the built-in web search and fetch tools work. Without live search, this skill can only organise what you paste in, and it must say so in the output.
- Optional: call notes, lost-deal reasons or a quote you received. Private: they inform the analysis but never appear in anything shared outside your team.
Steps
1. Fix the scope and the date
Write down the research date, competitor, product in scope, your product and the decision. "Current" means checked live today. Memory and old summaries are not evidence: re-find it or label it UNKNOWN.
2. Map their official sources first
Before searching the wider web, work through the competitor's own surfaces: homepage and navigation, product pages (one per module), pricing page with its footnotes, docs and help center (they state limits marketing skips), changelog and launch posts, security and terms pages, integrations listings, case studies, careers page and job posts, app store listings, and public filings if they file any. The sitemap often reveals pages the navigation hides. Save the exact URL and the date for every page you use. See references/source-guide.md for what each source is good and bad at.
3. Build the product map
For every module, record: exact public name, the job it does, who uses it, who buys it, key integrations, availability (generally available, beta, early access, waitlist, announced, roadmap) and which plan includes it.
When a launch post says "early access" and a later product page presents it as standard, record both and mark plan entitlement as UNKNOWN. Docs that describe current behavior beat an older marketing overview, but keep the conflict visible.
4. Sold vs delivered
Product pages show the promise. Look for the delivery:
- Docs and help articles: limits, quotas, required add-ons, "contact sales to enable".
- Job posts: roles in onboarding, implementation, customer success or professional services suggest how much hand-holding the product needs. Many open roles on one feature suggest it is new or struggling. Treat this as INFERRED, never as fact.
- Changelog: how often features ship versus how long they stay "coming soon".
- Reviews and community threads: setup time, support quality, missing features. Look for patterns across several reviews, not single angry posts.
Keep separate questions separate: does the capability exist, which plan gets it, is it included or extra, and who does the setup.
5. Pricing: evidence, not guesses
Record only what you can point to: published list prices, plan names, what each plan includes, billing terms and footnotes. For anything not published ("contact sales", enterprise tiers, discounts), write UNKNOWN and add a question to ask instead. A price from a third-party estimate or a forum post is at most CORROBORATED if two independent sources agree, and the battlecard must not quote it as their price.
6. Corroborate independently
Look for sources the competitor does not control: independent news, customer announcements on the customer's own site, review sites, customer conference talks, independent benchmarks. Classify by who wrote it, not where it is hosted: a vendor press release republished on a news site is still the vendor talking.
Never apply a benchmark of a different product to this competitor.
7. Infer the target customer
From case studies, pricing tiers, job posts, integrations and messaging, infer company size, industry, buyer role and trigger moment. Label it INFERRED and cite the evidence.
8. Find weaknesses you can use
A usable weakness has evidence and matters to your buyer. Write the weakness, its evidence and label, why the buyer cares, and a fair way to raise it (usually a question the prospect can test). Also write where they are genuinely stronger. A battlecard that admits strengths gets trusted.
"Not found in public sources" is not the same as "they don't have it." Say "we could not find X documented publicly", never "they can't do X".
9. Write the battlecard and evidence log
Fill templates/EVIDENCE-LOG.md as you go, then templates/BATTLECARD.md from it. Every battlecard line cites an evidence ID.
Evidence rules
Every claim gets exactly one label, a source and a date checked.
| Label | Meaning | Can go in "we can say"? |
| VERIFIED | The competitor's own current source states it directly (product page, docs, pricing page, filing). Verified means they say it, not that it is true in practice. | Yes, phrased as "their site says..." |
| CORROBORATED | Two or more independent sources agree, or an independent source confirms a vendor claim. | Yes, with care |
| VENDOR-CLAIMED | Performance, scale, ROI or customer results published by the competitor or in a vendor-hosted case study. | Only as "they claim..." |
| INFERRED | Your reasoning from evidence. Show the reasoning. | No. Use it to shape questions. |
| UNKNOWN | Not established publicly, or sources conflict. | No. Turn it into a question. |
More rules:
- Material claims need a direct URL, not a homepage, and a date checked. Pages change.
- When sources conflict, record both with dates. Do not pick the convenient one.
- A blocked or login-walled page is an access limit, not evidence the feature is missing.
- Customer logos prove a relationship existed at some point, not that the customer uses the product you are comparing today.
- Selected power users are not average users. Task-level time savings are not company-wide ROI. Keep the claim's own scope.
- Never invent numbers. If a figure is not in a source, it is UNKNOWN.
Output
Three files in the working folder (Claude Code) or three sections in the reply (Claude.ai):
- Evidence log (
evidence-log-<competitor>.mdfromtemplates/EVIDENCE-LOG.md): every claim with ID, label, source, date and a one-line note. - Battlecard (
battlecard-<competitor>.mdfromtemplates/BATTLECARD.md): one page a sales or marketing person can use on a call. - Short summary in the reply, five to eight lines: biggest overlap, strongest honest differentiator, biggest unknown, and any claim the team must stop making.
Before delivering, check: every battlecard line traces to an evidence ID; nothing INFERRED or UNKNOWN sits in "we can say"; no unpublished price is stated as fact; every "they can't" has become "we could not find"; their strengths section is not empty.
Honest limits
- Public sources show what a company says and ships. Private pricing, contracts, roadmap and real customer outcomes are mostly invisible.
- Reviews skew to the extremes; job posts show intent, not what every customer gets.
- If a key page could not be loaded, the report says so instead of filling the gap.
- Not legal advice. Public claims about a named competitor can carry legal risk; get external copy checked.
- No logging in under false pretences, scraping behind logins, or using confidential material someone should not have shared.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

