VK Ads skill for agencies
claude-skill-vk-ads
A Claude Code skill for VK Ads built for agencies: bulk operations, hashed remarketing audiences, ad-marking compliance and Google Sheets reports
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Creates, edits and bulk-stops clients' ad campaigns
- Uploads personal data (phones, emails) for remarketing, even if hashed
- Stores OAuth credentials for multiple client accounts
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/claude-skill-vk-adsDetects the agents on your machine, checks the risk and pins the version.
Other ways to install
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a claude-code -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a cursor -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a github-copilot -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a codex -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a gemini-cli -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a cline -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a roo -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
A fork of Roo Code, same .roo folders.
Run in a terminal in the project folder
npx skills add atomachinskiy/claude-skill-vk-ads --skill vk-ads -a opencode -yThe skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.
Clone the skill into ~/.claude/skills/vk-ads, create an OAuth app at ads.vk.com, save the client's client_id and client_secret to ~/.claude/secrets/vk-ads/clients/<slug>.env with 600 permissions, and verify the token with cli.py <slug> GET /api/v2/ad_plans.json.
Other ways from the author
git clone --depth 1 https://github.com/atomachinskiy/claude-skill-vk-ads.git ~/.claude/skills/vk-adsThe README's method; Claude Code picks up the skill automatically after cloning.
This is third-party code. Review the repository files before installing.
What it does
The skill turns Claude Code into a performance-marketer assistant on top of the VK Ads API: reads v2/v3 statistics, reach forecasts and audience insights, auto-fills monthly Google Sheets reports and exports leads from lead forms. It can create campaigns, ad groups and banners from templates, upload SHA-256 hashed phone/email remarketing audiences, build look-alike segments and run bulk operations up to 200 objects per request. A separate block handles Russia's mandatory ad-marking (ORD) for agency accounts, including reporting documents. Client credentials live outside the skill in a 700-permission folder and never enter git.
Who it is for. For agencies and freelancers running multiple VK Ads accounts who want to automate reporting and routine operations.
Good fit when
- You run several client VK Ads accounts with separate credentials
- You need automated ORD ad-marking for an agency account
- You need look-alike and hashed remarketing audiences without manual uploads
Not a fit when
- You only need to view statistics without campaign-editing rights
- You have no VK Ads OAuth application and do not want to set one up for a single account
Example request
Build a March report for client acme: top ads by ROMI and where the lead-form leads wentLimitations
The skill needs Python 3.11+ and a working Claude Code install, and some reports require Google Sheets API credentials. The author notes that a few management methods' request bodies still need live API exploration. There are no releases or a changelog, just the main branch.
How to disable. Delete the ~/.claude/skills/vk-ads folder and client files under ~/.claude/secrets/vk-ads.
Security check
- Creates, edits and bulk-stops clients' ad campaigns
- Uploads personal data (phones, emails) for remarketing, even if hashed
- Stores OAuth credentials for multiple client accounts
README in short
The README positions the skill as covering much of a senior VK performance marketer's work: analytics, template-based campaign launches, bulk management and agency ad-marking. It separately shows installation by cloning into the skills folder, requirements (Python 3.11+, Claude Code, a VK Ads OAuth app), per-client secrets kept outside git, and a direct API call to verify the token.
FAQ
How does the skill store data for different clients?
Each client is a separate env file under ~/.claude/secrets/vk-ads/clients with 600 permissions, and the secrets folder itself has 700 permissions.
Is Google Sheets required for the skill to work?
No, it is an optional part for auto-filling monthly reports; core analytics and campaign management work without it.
Related
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
Yandex Direct MCP generated from a machine-readable schema
yandex-direct-mcp
An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand