The @gods/skill CLI installs SKILL.md files into your AI coding agent. SKILL.md files give agents like Claude Code, Cursor, and Windsurf specialised capabilities without writing custom prompts.
Available SkillsLink to this section
| Skill | Description | Requires Account | Details |
|---|---|---|---|
| ad-performance-analyser-gods | Analyse ad data from any source (CSV, API, screenshots) | No | View skill page |
| gods-mcp-deep-ad-analysis | Analyse live Google Ads and Meta Ads via Gods MCP | Yes (free) | View skill page |
List all available skills:
npx @gods/skillInstall a SkillLink to this section
The CLI auto-detects your AI agent and installs the SKILL.md file to the correct location.
npx @gods/skill install ad-performance-analyser-godsnpx @gods/skill install gods-mcp-deep-ad-analysisTarget a Specific AgentLink to this section
npx @gods/skill install ad-performance-analyser-gods --agent=cursorTarget Multiple AgentsLink to this section
npx @gods/skill install ad-performance-analyser-gods --agent=claude-code,cursor,windsurfInstall All SkillsLink to this section
npx @gods/skill install --allSupported AgentsLink to this section
The CLI auto-detects and installs to the correct config location for each agent:
| Agent | Detection | Install Location |
|---|---|---|
| Claude Code | ~/.claude/ directory | ~/.claude/commands/ |
| Cursor | .cursor/ in project | .cursor/rules/ |
| Windsurf | .windsurf/ in project | .windsurf/rules/ |
| Codex CLI | codex binary | ~/.codex/instructions/ |
| Gemini CLI | gemini binary | ~/.gemini/instructions/ |
| OpenCode | opencode binary | ~/.opencode/instructions/ |
Remove a SkillLink to this section
npx @gods/skill remove ad-performance-analyser-godsUsing Skills with Gods MCPLink to this section
The gods-mcp-deep-ad-analysis skill works together with the Gods MCP server. Here’s how to set up both:
1. Get your API tokenLink to this section
Sign up at Telegram (free, no credit card). Then go to Gods > Settings > API & MCP and create a token.
2. Connect the MCP serverLink to this section
Follow the setup guide for your agent:
3. Install the MCP skillLink to this section
npx @gods/skill install gods-mcp-deep-ad-analysis4. Connect your ad platformsLink to this section
Open your agent and ask:
Connect my Google Ads account to Gods.The skill will walk you through the OAuth flow to link Google Ads, Meta Ads, or both.
5. Start queryingLink to this section
Once connected, the skill handles MCP tool orchestration automatically. Try:
Show me a performance overview for all ad accounts this month.Which campaigns have the highest CPA in the last 30 days?Compare Google Ads vs Meta Ads CPL for Q1.The skill batches up to 5 MCP queries per request and applies senior media buying analysis frameworks to the results.
The ad-performance-analyser-gods skill does not require MCP. It works with any data you paste into your agent (CSV exports, screenshots, API responses). Install it separately if you want offline analysis alongside live MCP queries.
What Is a SKILL.md?Link to this section
A SKILL.md is a portable markdown file that gives AI coding agents domain-specific knowledge and structured workflows. It contains:
- Context: Background knowledge the agent needs (e.g. ad platform benchmarks, analysis frameworks)
- Instructions: Step-by-step workflows the agent follows when triggered
- Guardrails: Rules that keep the agent on track (e.g. batch MCP queries, check data quality first)
SKILL.md files are open-source and work across all major AI coding agents without modification.
Next StepsLink to this section
- Ad Performance Analyser (works with any data, no account needed)
- MCP Deep Ad Analysis (live campaign data, free account required)
- MCP Quickstart Guide