{"_id":"@adbutler/skills","name":"@adbutler/skills","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@adbutler/skills","version":"1.0.0","description":"Reusable AI-agent skills for AdButler ad management workflows — campaign launch, VAST video, retail media, reporting, targeting, programmatic, contracts, channels, and drafts","type":"module","bin":{"adbutler-skills":"bin/cli.mjs"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/adbutler/skills.git"},"keywords":["adbutler","ai-skills","claude-code","cursor","copilot","advertising","mcp","vast","programmatic","retail-media"],"engines":{"node":">=18.0.0"},"gitHead":"0612ec3aa613158e160d0dd59138d0333c13af80","_id":"@adbutler/skills@1.0.0","bugs":{"url":"https://github.com/adbutler/skills/issues"},"homepage":"https://github.com/adbutler/skills#readme","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-q5+7/38L14QkF3CkUGTYByIn87sdz3Mb1tQ9Mr+LbVvjtJsGBvP5e5H5c0+ZCElOSzvAZmM5JwXDeA9tzDX2aA==","shasum":"4ec959689712a77c20e8d8feb7ce5a6dd1c02711","tarball":"https://registry.npmjs.org/@adbutler/skills/-/skills-1.0.0.tgz","fileCount":79,"unpackedSize":407432,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDkFaVwsilObeQt6OmP/YlRrvBvRh4xEo0eZWQ1Yqv+JAIhAPhni8CR92bgVTn8VaonWd4W36hJKagIrixgxr8WdDuY"}]},"_npmUser":{"name":"wasif","email":"general@sparklit.com"},"directories":{},"maintainers":[{"name":"wasif","email":"general@sparklit.com"},{"name":"tsparklit","email":"trevor@sparklit.com"},{"name":"jeffsparklit","email":"jeff@sparklit.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skills_1.0.0_1776201731303_0.6383581094534299"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-14T21:22:11.168Z","1.0.0":"2026-04-14T21:22:11.441Z","modified":"2026-04-14T21:22:11.750Z"},"maintainers":[{"name":"wasif","email":"general@sparklit.com"},{"name":"tsparklit","email":"trevor@sparklit.com"},{"name":"jeffsparklit","email":"jeff@sparklit.com"}],"description":"Reusable AI-agent skills for AdButler ad management workflows — campaign launch, VAST video, retail media, reporting, targeting, programmatic, contracts, channels, and drafts","homepage":"https://github.com/adbutler/skills#readme","keywords":["adbutler","ai-skills","claude-code","cursor","copilot","advertising","mcp","vast","programmatic","retail-media"],"repository":{"type":"git","url":"git+https://github.com/adbutler/skills.git"},"bugs":{"url":"https://github.com/adbutler/skills/issues"},"license":"MIT","readme":"# AdButler Skills\n\nReusable AI-agent skills for [AdButler](https://www.adbutler.com) ad management workflows. Each skill teaches AI coding agents (Claude Code, Cursor, Copilot) how to perform a specific AdButler workflow end-to-end.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| [Campaign Launch](skills/adbutler-campaign-launch/) | Create and launch a display ad campaign — advertiser, campaign, creatives, zones, scheduling, and placements |\n| [Retail Media Setup](skills/adbutler-retail-media-setup/) | Set up a retail media network with catalog zones, sponsored products, auction pricing, and bid floors |\n| [Reporting Dashboard](skills/adbutler-reporting-dashboard/) | Pull performance reports, forecasts, geo summaries, and manage saved report configurations |\n| [VAST Video](skills/adbutler-vast-video/) | Create VAST video ad campaigns with linear/non-linear media, companions, and tracking events |\n| [Programmatic](skills/adbutler-programmatic/) | Set up programmatic advertising with demand sources, demand endpoints, and PMP deals |\n| [Targeting & Audiences](skills/adbutler-targeting/) | Configure targeting rules — geo, platform, day-parting, data keys, list targets, audiences, and postal codes |\n| [Contract Management](skills/adbutler-contracts/) | Manage advertising contracts, templates, documents, payments, and signature requests |\n| [Channel Management](skills/adbutler-channels/) | Create channels to group zones for unified campaign delivery across multiple publishers |\n| [Draft Campaigns](skills/adbutler-drafts/) | Stage campaigns, ad items, and placements in draft mode before publishing live |\n\n## Prerequisites\n\n- An [AdButler](https://www.adbutler.com) account with API access\n- API key from AdButler Settings > API Keys\n- Set the environment variable: `export ADBUTLER_API_KEY=your_key_here`\n- Node.js 18+ (for running JavaScript templates)\n\n## How It Works\n\nEach skill contains:\n\n```\nskills/{skill-name}/\n  skill.json          # Machine-readable metadata\n  instructions.md     # AI-agent-readable step-by-step instructions\n  examples/           # 3 real-world usage examples\n  templates/          # Working JavaScript code\n    {skill}.mjs       # fetch()-based implementation\n    {skill}-mcp.mjs   # MCP tool sequence for when MCP server is connected\n```\n\n### For AI Agents\n\nThe `instructions.md` in each skill is written for AI agents, not humans. It includes:\n- Numbered steps with exact API endpoints and required fields\n- MCP tool mapping table for when the AdButler MCP server is connected\n- Decision trees for handling variations\n- Validation checklists to verify success\n- Common error table for troubleshooting\n\n### MCP Server Integration\n\nIf the [AdButler MCP server](https://www.npmjs.com/package/@adbutler/mcp-server) is connected, agents can use MCP tools directly instead of making API calls. Each skill's instructions include a mapping table showing which MCP tool corresponds to each step.\n\nInstall the MCP server: `npx -y @adbutler/mcp-server`\n\n## Usage with AI Coding Agents\n\n### Claude Code\n\nAdd the skill instructions to your project context:\n\n```bash\n# Reference in your CLAUDE.md\necho \"See /path/to/adbutler-skills/skills/adbutler-campaign-launch/instructions.md for campaign workflow\" >> CLAUDE.md\n```\n\nOr point Claude Code at the skill directly:\n```\nRead /path/to/adbutler-skills/skills/adbutler-campaign-launch/instructions.md and follow it to launch a campaign\n```\n\n### Cursor\n\nAdd to your `.cursorrules`:\n```\nWhen working with AdButler, reference the skills in /path/to/adbutler-skills/skills/ for workflows.\n```\n\n### Copilot\n\nAdd to your workspace instructions to reference the skill files for AdButler workflows.\n\n## Running Templates Directly\n\nEach skill includes runnable JavaScript templates:\n\n```bash\n# Set your API key\nexport ADBUTLER_API_KEY=your_key_here\n\n# Run a campaign launch\nnode skills/adbutler-campaign-launch/templates/campaign-launch.mjs\n\n# Run retail media setup\nnode skills/adbutler-retail-media-setup/templates/retail-media-setup.mjs\n\n# Run VAST video campaign\nnode skills/adbutler-vast-video/templates/vast-video.mjs\n```\n\n## Shared Library\n\nThe `lib/` directory contains shared utilities used by all skill templates:\n\n- `adbutler-client.mjs` — fetch()-based API client for AdButler v2\n- `errors.mjs` — Error classes and field validation helpers\n- `validators.mjs` — API key and input validation\n\n## API Reference\n\nAll skills use the [AdButler API v2](https://www.adbutler.com/api):\n- Base URL: `https://api.adbutler.com/v2`\n- Auth: `Authorization: Basic {API_KEY}` header\n- Format: JSON request/response bodies\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-fe566535a8ed5e38e9b24d33b6ef8e42"}