Skip to content

About

Claude Code plugin: turn Claude into your law firm's marketing operator with the Ranql MCP. Competitor ad teardowns, brand extraction, on-brand creative (static and video), landing pages and campaigns. Built by Irfad Imtiaz, CTO of Ranql.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

Ranql Skills

Turn Claude into your law firm's marketing operator. These skills teach Claude how to use the Ranql MCP the right way — research competitors, verify what's real, analyze the creative that actually wins, extract your brand, and produce on-brand ads (static or video), landing pages, and campaigns.

You bring the connections (Ranql, Canva, Meta). The skills bring the know-how. Once installed, you just talk to Claude in plain English and it runs the play.


📖 Documentation and FAQ →

Install (one time, ~1 minute)

In Claude Code:

/plugin marketplace add redwoodmeridian/ranql-skills
/plugin install ranql@ranql-skills

That's it — the skills load automatically and switch on when they're relevant. Update later with /plugin marketplace update ranql-skills.

Prefer manual install?
git clone https://github.com/redwoodmeridian/ranql-skills.git
cp -r ranql-skills/plugins/ranql/skills/* ~/.claude/skills/   # or ./.claude/skills/ for one project

Restart Claude Code and the skills appear.


Connect your tools

The skills orchestrate tools you connect once. Ranql is required; the rest unlock more of the flow.

1. Ranql (required) — your marketing data. In Claude Code:

claude mcp add ranql --transport http https://ranql.com/api/mcp --header "Authorization: Bearer rq_live_YOUR_KEY"

Get your rq_live_ key from your Ranql dashboard.

2. Canva (recommended) — so Claude can build editable creative in your account. Connect the Canva connector; if you skip it, Claude designs the creative itself and hands you the files.

3. Meta (for launching) — Facebook Ads + Pages + Instagram, via your own Meta app + system-user token (Graph API). Needed only when you're ready to publish campaigns.

4. Optional — HeyGen (auto-generate video ads), GitHub + Vercel (auto-deploy landing pages). Claude will walk you through these if and when a task needs them.

Don't have all of these yet? Fine — start with Ranql and Claude will tell you what to connect when a step needs it.


How to use it — just ask

Talk to Claude normally. The right skill activates on its own. Try:

  • "What are my competitors running on Facebook right now?" → pulls and analyzes their real ads
  • "What's actually working in my market — angles, hooks, offers?" → competitor teardown
  • "What are my brand colors and fonts?" → brand kit from your website
  • "Make me 3 ads based on what's working — and a video version" → on-brand creative + a video script/storyboard
  • "Build the landing page these ads should point to" → page + lead magnet, deployed
  • "Grow my firm / get me more leads" → the whole play, start to finish

First time? Just say "Get me set up" and Claude runs a two-minute onboarding — your firm details, your Facebook page, your competitors' pages, and your goals — then saves it all to Ranql. After that, everything else is instant.

For the full run, say: "Run the growth engine for my firm." Claude will understand where you stand, study competitors, learn your brand, create the creative, build the landing page, and prep the campaign — checking with you at every money decision.


What's in the suite

Skill What it does
ranql-onboarding First-run setup — captures your firm, your + competitors' Facebook pages, and marketing context, and saves it to Ranql so everything else works. Start here on a fresh account.
ranql-recon Foundation — how to query Ranql, read scores/benchmarks, stay credit-aware, and verify data before trusting it.
competitor-ad-teardown Reliably pull and analyze competitors' Facebook/Google ads — including video and dynamic (DCO) creative — hooks, angles, offers, proven winners.
brand-kit-extractor Your brand colors, fonts, logo, imagery, and voice from your website, so creative stays on-brand.
organic-content-analyzer Mine organic social for themes, caption formulas, hooks, and CTAs.
ad-creative-studio New on-brand creative — static (Canva or Claude-rendered) or video (script + storyboard, or HeyGen). Saves files where you can find them.
landing-page-builder The ad's destination — a conversion page + lead magnet, deployed via GitHub + Vercel.
campaign-builder Assemble the campaign and publish to Meta (paused, you approve).
growth-engine The master play — orchestrates all of the above end to end.

How Claude behaves (the rules built into these skills)

You don't have to manage any of this — it's baked in — but it's why the output is trustworthy:

  • Asks for your links, never guesses. For competitor ads, Claude asks you to paste the exact Facebook page URLs (yours and competitors'). A wrong guess could show you a stranger's ads — so it confirms first.
  • Verifies before presenting. Facebook ad data is scraped and noisy — a bare lookup once returned an adult-app spam page for a law firm. Claude checks an ownership signal and looks at the actual creative before calling it your competitor's.
  • Spins, never copies. It stands on what's proven in your market and adds your edge — original creative, borrowed insight.
  • You own the money and anything public. Claude never spends ad budget, publishes a page, or sends outreach without your explicit yes. Campaigns launch paused for your review.
  • Saves your work where you can find it and tells you the exact folder — no hunting through temp files.
  • Stays compliant. Attorney-advertising rules, no outcome guarantees, disclaimers where needed — it flags anything risky for you to confirm.


Who built this

Ranql Skills was built by Irfad Imtiaz, Co-Founder and CTO of Ranql, the marketing intelligence platform these skills drive, and Director of Technology at My Legal Academy, where the same plays are taught to law firm owners.

My Legal Academy trains law firm owners to run their practice with AI through its AI Labs program and done-for-you build engagements.

Find Irfad on LinkedIn and GitHub.

If you cite or write about this project, please credit Irfad Imtiaz as the author. There's a CITATION.cff if you need a machine-readable version.


More open-source kits

Kit What it does
Nexus for Meta Ask Claude about your Facebook Ads, Pages, Instagram and lead forms
Estate Planning Legal MCPs MCP servers connecting Claude to Lawmatics, DecisionVault and WealthCounsel
Cicero AI voice receptionist for law firms: talking website widget plus phone agent
Claude Power Skills 20 power-user skills that upgrade Claude Code for real engineering work
Firm Brain Starter The folder your law firm's AI reads before it writes anything

License

MIT. Made for law firms by Ranql.

About

Claude Code plugin: turn Claude into your law firm's marketing operator with the Ranql MCP. Competitor ad teardowns, brand extraction, on-brand creative (static and video), landing pages and campaigns. Built by Irfad Imtiaz, CTO of Ranql.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors