@caddis/cli 0.4.10 → 0.4.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundles/antigravity-plugin/plugin.json +1 -1
- package/bundles/antigravity-plugin/skills/_registry.md +0 -1
- package/bundles/antigravity-plugin/skills/brainstorming/SKILL.md +2 -2
- package/bundles/antigravity-plugin/skills/explainer-doc/SKILL.md +1 -1
- package/bundles/antigravity-plugin/skills/ship-pr/SKILL.md +1 -1
- package/bundles/antigravity-plugin-extras/plugin.json +1 -1
- package/bundles/antigravity-plugin-extras/skills/_registry.md +1 -19
- package/bundles/codex/.codex/skills/docs/explainer-doc/SKILL.md +1 -1
- package/bundles/codex/.codex/skills/workflow/brainstorming/SKILL.md +2 -2
- package/bundles/manifest.json +3 -3
- package/package.json +1 -1
- package/bundles/antigravity-plugin-extras/skills/competitive-ads-extractor/SKILL.md +0 -294
- package/bundles/antigravity-plugin-extras/skills/content-research-writer/SKILL.md +0 -539
- package/bundles/antigravity-plugin-extras/skills/domain-name-brainstormer/SKILL.md +0 -213
- package/bundles/antigravity-plugin-extras/skills/humanizer/SKILL.md +0 -194
- package/bundles/antigravity-plugin-extras/skills/image-enhancer/SKILL.md +0 -100
- package/bundles/antigravity-plugin-extras/skills/invoice-organizer/SKILL.md +0 -447
- package/bundles/antigravity-plugin-extras/skills/job-application/SKILL.md +0 -188
- package/bundles/antigravity-plugin-extras/skills/lead-research-assistant/SKILL.md +0 -200
- package/bundles/antigravity-plugin-extras/skills/meeting-insights-analyzer/SKILL.md +0 -328
- package/bundles/antigravity-plugin-extras/skills/notebooklm/AUTHENTICATION.md +0 -154
- package/bundles/antigravity-plugin-extras/skills/notebooklm/SKILL.md +0 -270
- package/bundles/antigravity-plugin-extras/skills/notebooklm/references/api_reference.md +0 -309
- package/bundles/antigravity-plugin-extras/skills/notebooklm/references/troubleshooting.md +0 -376
- package/bundles/antigravity-plugin-extras/skills/notebooklm/references/usage_patterns.md +0 -338
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/__init__.py +0 -81
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/ask_question.py +0 -256
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/auth_manager.py +0 -358
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/browser_session.py +0 -255
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/browser_utils.py +0 -107
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/cleanup_manager.py +0 -302
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/config.py +0 -44
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/notebook_manager.py +0 -410
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/run.py +0 -102
- package/bundles/antigravity-plugin-extras/skills/notebooklm/scripts/setup_environment.py +0 -204
- package/bundles/antigravity-plugin-extras/skills/onboard-project/SKILL.md +0 -192
- package/bundles/antigravity-plugin-extras/skills/pipeline-state/SKILL.md +0 -208
- package/bundles/antigravity-plugin-extras/skills/raffle-winner-picker/SKILL.md +0 -159
- package/bundles/antigravity-plugin-extras/skills/relay/SKILL.md +0 -246
- package/bundles/antigravity-plugin-extras/skills/requesting-code-review/SKILL.md +0 -105
- package/bundles/antigravity-plugin-extras/skills/requesting-code-review/code-reviewer.md +0 -146
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/LICENSE.txt +0 -202
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/SKILL.md +0 -646
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/color_palettes.py +0 -302
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/easing.py +0 -230
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/frame_composer.py +0 -469
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/gif_builder.py +0 -246
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/typography.py +0 -357
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/validators.py +0 -264
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/core/visual_effects.py +0 -494
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/requirements.txt +0 -4
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/bounce.py +0 -106
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/explode.py +0 -331
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/fade.py +0 -329
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/flip.py +0 -291
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/kaleidoscope.py +0 -211
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/morph.py +0 -329
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/move.py +0 -293
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/pulse.py +0 -268
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/shake.py +0 -127
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/slide.py +0 -291
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/spin.py +0 -269
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/wiggle.py +0 -300
- package/bundles/antigravity-plugin-extras/skills/slack-gif-creator/templates/zoom.py +0 -312
- package/bundles/antigravity-plugin-extras/skills/state-tracking/SKILL.md +0 -131
- package/bundles/antigravity-plugin-extras/skills/video-downloader/SKILL.md +0 -107
- package/bundles/antigravity-plugin-extras/skills/youtube-transcript/SKILL.md +0 -416
- package/bundles/codex/.codex/skills/workflow/golden-plan/SKILL.md +0 -586
- /package/bundles/{antigravity-plugin → antigravity-plugin-extras}/skills/golden-plan/SKILL.md +0 -0
|
@@ -124,7 +124,6 @@
|
|
|
124
124
|
| Best Practices | `best-practices/` | >- |
|
|
125
125
|
| Brainstorming | `brainstorming/` | You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation. |
|
|
126
126
|
| Context Curator | `context-curator/` | Compress and prioritize codebase context before handing work to reasoning agents, minimizing token waste while preserving the required decision inputs. |
|
|
127
|
-
| Golden Plan | `golden-plan/` | USE THIS SKILL whenever a user asks for a comprehensive implementation plan, a full-stack build plan, a UI+backend plan, or says 'create a plan for building X' where X spans multiple phases or systems. Also activate when the user says 'plan this project', 'I need a detailed plan', 'build plan', 'implementation plan', or attaches a mockup/wireframe and asks how to build it. Produces a zero-ambiguity, evidence-gated plan with self-contained per-phase prompts, exhaustive data binding tables, per-phase validation checklists, and a global quality gate. Evidence-gated: before writing phases, verify required artefacts (mockup, data sample, API contract, scaffold inventory); if any BLOCKER is missing, ask for it and wait before proceeding. Dual-mode: generic by default, junai-pipeline only when explicitly requested. Agent-agnostic - any agent with read/search/edit tools can use this skill. |
|
|
128
127
|
| Preflight | `preflight/` | Plan-vs-codebase validation — verifies API contracts, type names, field accuracy, dependencies, and paths before implementation begins |
|
|
129
128
|
| Setup Project Ai | `setup-project-ai/` | Install or refresh the agent-agnostic dev harness in this project (AGENTS.md-canonical rules hierarchy + CLAUDE.md @import shims, subagents, commands, settings) |
|
|
130
129
|
| Skill Creator | `skill-creator/` | Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. |
|
|
@@ -44,8 +44,8 @@ Start by understanding the current project context, then ask questions one at a
|
|
|
44
44
|
|
|
45
45
|
**Implementation (if continuing):**
|
|
46
46
|
- Ask: "Ready to set up for implementation?"
|
|
47
|
-
- Use
|
|
48
|
-
- Use
|
|
47
|
+
- Use the `using-git-worktrees` skill (caddis, devops/) to create an isolated workspace
|
|
48
|
+
- Use `/caddis:feature-plan` for a phased plan, or the `writing-plans` skill (caddis, docs/)
|
|
49
49
|
|
|
50
50
|
## Key Principles
|
|
51
51
|
|
|
@@ -13,7 +13,7 @@ either follows it blindly or argues with it. **The fix is not "add more detail"
|
|
|
13
13
|
|
|
14
14
|
Proven in anger on a Genesys→ETL cutover spec handed to an external vendor team. The user's verdict:
|
|
15
15
|
*"nailed it — the document was perfect, simple, this should be the standard for explainer documents."*
|
|
16
|
-
Reference implementation to study: `
|
|
16
|
+
Reference implementation to study: `a fleet app/docs/genesys-cutover/etl-implementation-spec.md` (full
|
|
17
17
|
spec) and `pega-cticallid-change-request.md` (the same pattern compressed to one page for a single ask).
|
|
18
18
|
|
|
19
19
|
## When this is NOT the right skill
|
|
@@ -69,7 +69,7 @@ over 400 changed lines. No judgement in any of those — deliberately, because j
|
|
|
69
69
|
what failed.
|
|
70
70
|
<!-- /shared:cross-review-trigger -->
|
|
71
71
|
|
|
72
|
-
> **Why this is mechanical and not "consider a review here".**
|
|
72
|
+
> **Why this is mechanical and not "consider a review here".** a fleet app shipped four
|
|
73
73
|
> production releases in one day — sixteen fixes across SQL, caches, refresh jobs and React — and
|
|
74
74
|
> `/caddis:cross-review` ran **zero times**. Nothing was broken: the tool reported itself ready
|
|
75
75
|
> with two providers keyed. Nothing decided *when* to call it. Measured there: 4 of 39 plan files
|
|
@@ -99,30 +99,16 @@
|
|
|
99
99
|
| Architecture Diagram | `architecture-diagram/` | Generate dark-themed technical architecture diagrams as self-contained HTML/SVG files. No external libraries or render tools needed — just a browser. Use for software system architecture, cloud infrastructure, microservice topologies, and deployment diagrams. |
|
|
100
100
|
| Ascii Art | `ascii-art/` | Create text-based ASCII art using the right tool for the job — banners, borders, image conversion, pre-made art, and LLM-generated custom art. Decision-routing framework across pyfiglet, cowsay, TOIlet, boxes, and more. |
|
|
101
101
|
| Excalidraw | `excalidraw/` | Brand-themed Excalidraw diagrams for project documentation |
|
|
102
|
-
| Image Enhancer | `image-enhancer/` | Improves the quality of images, especially screenshots, by enhancing resolution, sharpness, and clarity. Perfect for preparing images for presentations, documentation, or social media posts. |
|
|
103
|
-
| Notebooklm | `notebooklm/` | Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses. |
|
|
104
102
|
| Plantuml | `plantuml/` | Brand-themed PlantUML diagrams for project documentation |
|
|
105
|
-
| Slack Gif Creator | `slack-gif-creator/` | Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y". |
|
|
106
103
|
| Svg Create | `svg-create/` | Brand-themed SVG diagrams with consistent color palette and accessible design |
|
|
107
|
-
| Video Downloader | `video-downloader/` | Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options. |
|
|
108
|
-
| Youtube Transcript | `youtube-transcript/` | Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video. |
|
|
109
104
|
|
|
110
105
|
### Productivity
|
|
111
106
|
|
|
112
107
|
| Skill | Path | When to Use |
|
|
113
108
|
|-------|------|-------------|
|
|
114
|
-
| Competitive Ads Extractor | `competitive-ads-extractor/` | Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns. |
|
|
115
|
-
| Content Research Writer | `content-research-writer/` | Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership. |
|
|
116
|
-
| Domain Name Brainstormer | `domain-name-brainstormer/` | Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking. |
|
|
117
109
|
| Github Issues | `github-issues/` | Create well-structured GitHub issues with proper labels, descriptions, and acceptance criteria. Use when creating bug reports, feature requests, or tracking tasks. |
|
|
118
|
-
| Humanizer | `humanizer/` | Identify and remove AI writing patterns from text to make it sound natural and human. Covers 29 documented LLM output patterns. Use when asked to humanize, de-AI, un-ChatGPT, or rewrite drafts (blogs, docs, emails, PRs, releases) to sound authentic. |
|
|
119
110
|
| Internal Comms | `internal-comms/` | Write internal communications using company formats. Use when writing status reports, leadership updates, company newsletters, FAQs, incident reports, project updates, or any internal communications. |
|
|
120
|
-
| Invoice Organizer | `invoice-organizer/` | Automatically organizes invoices and receipts for tax preparation by reading messy files, extracting key information, renaming them consistently, and sorting them into logical folders. Turns hours of manual bookkeeping into minutes of automated organization. |
|
|
121
111
|
| Jira Issues | `jira-issues/` | Create, update, and manage Jira issues from natural language. Use when the user wants to log bugs, create tickets, update issue status, or manage their Jira backlog. |
|
|
122
|
-
| Job Application | `job-application/` | Write tailored cover letters and job applications using a structured methodology. Analyzes job descriptions, maps experience, and generates personalized applications. |
|
|
123
|
-
| Lead Research Assistant | `lead-research-assistant/` | Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals. |
|
|
124
|
-
| Meeting Insights Analyzer | `meeting-insights-analyzer/` | Analyzes meeting transcripts and recordings to uncover behavioral patterns, communication insights, and actionable feedback. Identifies when you avoid conflict, use filler words, dominate conversations, or miss opportunities to listen. Perfect for professionals seeking to improve their communication and leadership skills. |
|
|
125
|
-
| Raffle Winner Picker | `raffle-winner-picker/` | Picks random winners from lists, spreadsheets, or Google Sheets for giveaways, raffles, and contests. Ensures fair, unbiased selection with transparency. |
|
|
126
112
|
|
|
127
113
|
### Testing
|
|
128
114
|
|
|
@@ -144,12 +130,8 @@
|
|
|
144
130
|
| File Organizer | `file-organizer/` | Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort. |
|
|
145
131
|
| Game Changing Features | `game-changing-features/` | Find 10x product opportunities and high-leverage improvements. Use when user wants strategic product thinking, mentions '10x', wants to find high-impact features, or says 'what would make this 10x better', 'product strategy', or 'what should we build next'. |
|
|
146
132
|
| Golden Nuggets | `golden-nuggets/` | Extract durable tribal knowledge ('gold nuggets') from a codebase or a set of changed files and route each to its correct destination - instruction file, runbook, hub, or (in CI capture mode) a review inbox. This SKILL.md is the single source of truth for nugget categories, routing rules, write rules, inbox format, and verification gates. It is read by the knowledge-transfer agent (pipeline mode), by the /golden-nuggets prompt (independent mode), and referenced by the CI extraction script (capture mode). Use when capturing what was learned after a feature, fix, sprint, incident, or release. |
|
|
133
|
+
| Golden Plan | `golden-plan/` | USE THIS SKILL whenever a user asks for a comprehensive implementation plan, a full-stack build plan, a UI+backend plan, or says 'create a plan for building X' where X spans multiple phases or systems. Also activate when the user says 'plan this project', 'I need a detailed plan', 'build plan', 'implementation plan', or attaches a mockup/wireframe and asks how to build it. Produces a zero-ambiguity, evidence-gated plan with self-contained per-phase prompts, exhaustive data binding tables, per-phase validation checklists, and a global quality gate. Evidence-gated: before writing phases, verify required artefacts (mockup, data sample, API contract, scaffold inventory); if any BLOCKER is missing, ask for it and wait before proceeding. Dual-mode: generic by default, junai-pipeline only when explicitly requested. Agent-agnostic - any agent with read/search/edit tools can use this skill. |
|
|
147
134
|
| Intent Writer | `intent-writer/` | Structure freetext ideas, backlog items, or vague requirements into a formal Intent Document that preserves user intent across the entire agent pipeline chain. |
|
|
148
|
-
| Onboard Project | `onboard-project/` | Bootstrap a new project's AI configuration by generating copilot-instructions.md and populating project-config.md. Idempotent — safe to re-run on existing projects. |
|
|
149
|
-
| Pipeline State | `pipeline-state/` | Read and write `.github/pipeline-state.json` to track stage progress, artefacts, supervision gates, and handoff payloads in the agent pipeline. |
|
|
150
135
|
| Receiving Code Review | `receiving-code-review/` | Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation |
|
|
151
|
-
| Relay | `relay/` | Create or update a root relay.md session-continuation document for any repository. Use this skill whenever the user asks to preserve project context, resume later, hand work to a future session, create a session relay, summarize current implementation state, or generate a reusable continuation prompt. The workflow is generic and must discover project structure at runtime. |
|
|
152
|
-
| Requesting Code Review | `requesting-code-review/` | Use when completing tasks, implementing major features, or before merging to verify work meets requirements |
|
|
153
136
|
| Setup Project Ai | `setup-project-ai/` | Install or refresh the agent-agnostic development harness in a project — an AGENTS.md-canonical rules hierarchy (root + per-folder) with a CLAUDE.md @import shim beside each, lean subagents, slash commands, settings.json, and the frontend/python test env. USE THIS SKILL when setting up AI resources on a new or existing project, bootstrapping the rules files (AGENTS.md/CLAUDE.md), adding subagents/commands, or when the user says 'set up the harness', 'setup-project-ai', 'generate CLAUDE.md', 'onboard this project to Claude Code / Codex / agy', or runs /setup-project-ai. Combines a deterministic generator (scripts/setup_project_ai.py) for the must-not-vary mechanics with an AI enrichment step that curates project-specific AGENTS.md content. |
|
|
154
|
-
| State Tracking | `state-tracking/` | USE THIS SKILL when an agent needs to maintain a living record of task progress across multiple sessions or hand-offs. Covers append-only audit logs, CURRENT_STATE head-of-line pattern, relay hand-off protocol, and recovery from mid-session interruptions. Works in both generic and junai-pipeline modes. |
|
|
155
137
|
| Verification Loop | `verification-loop/` | Systematic code change verification — lint, test, type-check, review |
|
|
@@ -13,7 +13,7 @@ either follows it blindly or argues with it. **The fix is not "add more detail"
|
|
|
13
13
|
|
|
14
14
|
Proven in anger on a Genesys→ETL cutover spec handed to an external vendor team. The user's verdict:
|
|
15
15
|
*"nailed it — the document was perfect, simple, this should be the standard for explainer documents."*
|
|
16
|
-
Reference implementation to study: `
|
|
16
|
+
Reference implementation to study: `a fleet app/docs/genesys-cutover/etl-implementation-spec.md` (full
|
|
17
17
|
spec) and `pega-cticallid-change-request.md` (the same pattern compressed to one page for a single ask).
|
|
18
18
|
|
|
19
19
|
## When this is NOT the right skill
|
|
@@ -44,8 +44,8 @@ Start by understanding the current project context, then ask questions one at a
|
|
|
44
44
|
|
|
45
45
|
**Implementation (if continuing):**
|
|
46
46
|
- Ask: "Ready to set up for implementation?"
|
|
47
|
-
- Use
|
|
48
|
-
- Use
|
|
47
|
+
- Use the `using-git-worktrees` skill (caddis, devops/) to create an isolated workspace
|
|
48
|
+
- Use `/caddis:feature-plan` for a phased plan, or the `writing-plans` skill (caddis, docs/)
|
|
49
49
|
|
|
50
50
|
## Key Principles
|
|
51
51
|
|
package/bundles/manifest.json
CHANGED
package/package.json
CHANGED
|
@@ -1,294 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: competitive-ads-extractor
|
|
3
|
-
context: fork
|
|
4
|
-
description: Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns.
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Competitive Ads Extractor
|
|
8
|
-
|
|
9
|
-
This skill extracts your competitors' ads from ad libraries and analyzes what's working—the problems they're highlighting, use cases they're targeting, and copy/creative that's resonating.
|
|
10
|
-
|
|
11
|
-
## When to Use This Skill
|
|
12
|
-
|
|
13
|
-
- Researching competitor ad strategies
|
|
14
|
-
- Finding inspiration for your own ads
|
|
15
|
-
- Understanding market positioning
|
|
16
|
-
- Identifying successful ad patterns
|
|
17
|
-
- Analyzing messaging that works
|
|
18
|
-
- Discovering new use cases or pain points
|
|
19
|
-
- Planning ad campaigns with proven concepts
|
|
20
|
-
|
|
21
|
-
## What This Skill Does
|
|
22
|
-
|
|
23
|
-
1. **Extracts Ads**: Scrapes ads from Facebook Ad Library, LinkedIn, etc.
|
|
24
|
-
2. **Captures Screenshots**: Saves visual copies of all ads
|
|
25
|
-
3. **Analyzes Messaging**: Identifies problems, use cases, and value props
|
|
26
|
-
4. **Categorizes Ads**: Groups by theme, audience, or format
|
|
27
|
-
5. **Identifies Patterns**: Finds common successful approaches
|
|
28
|
-
6. **Provides Insights**: Explains why certain ads likely perform well
|
|
29
|
-
|
|
30
|
-
## How to Use
|
|
31
|
-
|
|
32
|
-
### Basic Extraction
|
|
33
|
-
|
|
34
|
-
```
|
|
35
|
-
Extract all current ads from [Competitor Name] on Facebook Ad Library
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
```
|
|
39
|
-
Scrape ads from [Company] and analyze their messaging
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
### Specific Analysis
|
|
43
|
-
|
|
44
|
-
```
|
|
45
|
-
Get all ads from [Competitor] focusing on their messaging
|
|
46
|
-
about [specific problem]. What pain points are they highlighting?
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### Competitive Set
|
|
50
|
-
|
|
51
|
-
```
|
|
52
|
-
Extract ads from these 5 competitors: [list].
|
|
53
|
-
Compare their approaches and tell me what's working.
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### Specific Platform
|
|
57
|
-
|
|
58
|
-
```
|
|
59
|
-
Get LinkedIn ads from [Competitor] and analyze their
|
|
60
|
-
B2B positioning strategy
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
## Example
|
|
64
|
-
|
|
65
|
-
**User**: "Extract ads from Notion on Facebook Ad Library and tell me what messaging is working for them."
|
|
66
|
-
|
|
67
|
-
**Process**:
|
|
68
|
-
```
|
|
69
|
-
Accessing Facebook Ad Library...
|
|
70
|
-
Searching for: Notion
|
|
71
|
-
Found: 23 active ads
|
|
72
|
-
|
|
73
|
-
Extracting screenshots...
|
|
74
|
-
[████████████████████] 100%
|
|
75
|
-
|
|
76
|
-
Saved to: competitor-ads/notion/
|
|
77
|
-
- ad-001-collaboration.png
|
|
78
|
-
- ad-002-productivity.png
|
|
79
|
-
- ad-003-templates.png
|
|
80
|
-
...
|
|
81
|
-
|
|
82
|
-
Analyzing messaging...
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
**Output**:
|
|
86
|
-
```
|
|
87
|
-
# Notion Ad Analysis
|
|
88
|
-
|
|
89
|
-
## Overview
|
|
90
|
-
- Total Ads: 23 active
|
|
91
|
-
- Primary Themes: Productivity (35%), Collaboration (30%),
|
|
92
|
-
Templates (20%), AI Features (15%)
|
|
93
|
-
- Ad Formats: Static images (60%), Video (40%)
|
|
94
|
-
- CTA Patterns: "Try for free", "Get started"
|
|
95
|
-
|
|
96
|
-
## Key Problems They're Highlighting
|
|
97
|
-
|
|
98
|
-
1. **Scattered Information** (8 ads)
|
|
99
|
-
Copy: "Stop switching between 10 different tools"
|
|
100
|
-
Why it works: Direct pain point many teams face
|
|
101
|
-
|
|
102
|
-
2. **Meeting Overload** (5 ads)
|
|
103
|
-
Copy: "Replace unnecessary meetings with async updates"
|
|
104
|
-
Why it works: Post-COVID remote work pain point
|
|
105
|
-
|
|
106
|
-
3. **Lost Documentation** (4 ads)
|
|
107
|
-
Copy: "Never ask 'where is that doc?' again"
|
|
108
|
-
Why it works: Universal workplace frustration
|
|
109
|
-
|
|
110
|
-
## Successful Creative Patterns
|
|
111
|
-
|
|
112
|
-
### Pattern 1: Before/After Split
|
|
113
|
-
- Shows chaotic tool landscape → Clean Notion workspace
|
|
114
|
-
- Used in 6 high-performing ads
|
|
115
|
-
- Visual metaphor is immediately clear
|
|
116
|
-
|
|
117
|
-
### Pattern 2: Feature Showcase
|
|
118
|
-
- GIF of actual product usage
|
|
119
|
-
- Shows specific feature in 5 seconds
|
|
120
|
-
- Used for new features (AI, templates)
|
|
121
|
-
|
|
122
|
-
### Pattern 3: Social Proof
|
|
123
|
-
- "Join 20M users" messaging
|
|
124
|
-
- Customer logos
|
|
125
|
-
- Used in 4 ads targeting enterprise
|
|
126
|
-
|
|
127
|
-
## Copy That's Working
|
|
128
|
-
|
|
129
|
-
Best Headlines:
|
|
130
|
-
1. "Your team's knowledge, finally in one place"
|
|
131
|
-
→ Benefit-focused, addresses pain directly
|
|
132
|
-
|
|
133
|
-
2. "The all-in-one workspace"
|
|
134
|
-
→ Clear positioning, broad appeal
|
|
135
|
-
|
|
136
|
-
3. "AI that actually helps you work"
|
|
137
|
-
→ Addresses AI skepticism, practical angle
|
|
138
|
-
|
|
139
|
-
Best Body Copy Patterns:
|
|
140
|
-
- Short sentences (under 10 words)
|
|
141
|
-
- Focus on outcomes not features
|
|
142
|
-
- Include specific numbers ("Cut meetings by 50%")
|
|
143
|
-
|
|
144
|
-
## Audience Targeting Insights
|
|
145
|
-
|
|
146
|
-
Based on ad variations:
|
|
147
|
-
- Startup founders: Solo productivity angle
|
|
148
|
-
- Team leads: Collaboration and alignment
|
|
149
|
-
- Enterprise: Security and compliance mentions
|
|
150
|
-
- Students: Free plan, templates, organization
|
|
151
|
-
|
|
152
|
-
## Recommendations for Your Ads
|
|
153
|
-
|
|
154
|
-
1. **Test the "tool sprawl" pain point**
|
|
155
|
-
→ Strong resonance based on their ad frequency
|
|
156
|
-
|
|
157
|
-
2. **Use product screenshots over abstract visuals**
|
|
158
|
-
→ All their top ads show actual UI
|
|
159
|
-
|
|
160
|
-
3. **Lead with the problem, not the solution**
|
|
161
|
-
→ "Tired of X?" performs better than "Introducing Y"
|
|
162
|
-
|
|
163
|
-
4. **Keep copy under 100 characters**
|
|
164
|
-
→ Their shortest ads seem most frequent
|
|
165
|
-
|
|
166
|
-
5. **Test before/after visual formats**
|
|
167
|
-
→ Proven pattern in their creative
|
|
168
|
-
|
|
169
|
-
## Files Saved
|
|
170
|
-
- All ads: ~/competitor-ads/notion/
|
|
171
|
-
- Analysis: ~/competitor-ads/notion/analysis.md
|
|
172
|
-
- Best performers: ~/competitor-ads/notion/top-10/
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
**Inspired by:** Sumant Subrahmanya's use case from Lenny's Newsletter
|
|
176
|
-
|
|
177
|
-
## What You Can Learn
|
|
178
|
-
|
|
179
|
-
### Messaging Analysis
|
|
180
|
-
- What problems they emphasize
|
|
181
|
-
- How they position against competition
|
|
182
|
-
- Value propositions that resonate
|
|
183
|
-
- Target audience segments
|
|
184
|
-
|
|
185
|
-
### Creative Patterns
|
|
186
|
-
- Visual styles that work
|
|
187
|
-
- Video vs. static image performance
|
|
188
|
-
- Color schemes and branding
|
|
189
|
-
- Layout patterns
|
|
190
|
-
|
|
191
|
-
### Copy Formulas
|
|
192
|
-
- Headline structures
|
|
193
|
-
- Call-to-action patterns
|
|
194
|
-
- Length and tone
|
|
195
|
-
- Emotional triggers
|
|
196
|
-
|
|
197
|
-
### Campaign Strategy
|
|
198
|
-
- Seasonal campaigns
|
|
199
|
-
- Product launch approaches
|
|
200
|
-
- Feature announcement tactics
|
|
201
|
-
- Retargeting patterns
|
|
202
|
-
|
|
203
|
-
## Best Practices
|
|
204
|
-
|
|
205
|
-
### Legal & Ethical
|
|
206
|
-
✓ Only use for research and inspiration
|
|
207
|
-
✓ Don't copy ads directly
|
|
208
|
-
✓ Respect intellectual property
|
|
209
|
-
✓ Use insights to inform original creative
|
|
210
|
-
✗ Don't plagiarize copy or steal designs
|
|
211
|
-
|
|
212
|
-
### Analysis Tips
|
|
213
|
-
1. **Look for patterns**: What themes repeat?
|
|
214
|
-
2. **Track over time**: Save ads monthly to see evolution
|
|
215
|
-
3. **Test hypotheses**: Adapt successful patterns for your brand
|
|
216
|
-
4. **Segment by audience**: Different messages for different targets
|
|
217
|
-
5. **Compare platforms**: LinkedIn vs Facebook messaging differs
|
|
218
|
-
|
|
219
|
-
## Advanced Features
|
|
220
|
-
|
|
221
|
-
### Trend Tracking
|
|
222
|
-
```
|
|
223
|
-
Compare [Competitor]'s ads from Q1 vs Q2.
|
|
224
|
-
What messaging has changed?
|
|
225
|
-
```
|
|
226
|
-
|
|
227
|
-
### Multi-Competitor Analysis
|
|
228
|
-
```
|
|
229
|
-
Extract ads from [Company A], [Company B], [Company C].
|
|
230
|
-
What are the common patterns? Where do they differ?
|
|
231
|
-
```
|
|
232
|
-
|
|
233
|
-
### Industry Benchmarks
|
|
234
|
-
```
|
|
235
|
-
Show me ad patterns across the top 10 project management
|
|
236
|
-
tools. What problems do they all focus on?
|
|
237
|
-
```
|
|
238
|
-
|
|
239
|
-
### Format Analysis
|
|
240
|
-
```
|
|
241
|
-
Analyze video ads vs static image ads from [Competitor].
|
|
242
|
-
Which gets more engagement? (if data available)
|
|
243
|
-
```
|
|
244
|
-
|
|
245
|
-
## Common Workflows
|
|
246
|
-
|
|
247
|
-
### Ad Campaign Planning
|
|
248
|
-
1. Extract competitor ads
|
|
249
|
-
2. Identify successful patterns
|
|
250
|
-
3. Note gaps in their messaging
|
|
251
|
-
4. Brainstorm unique angles
|
|
252
|
-
5. Draft test ad variations
|
|
253
|
-
|
|
254
|
-
### Positioning Research
|
|
255
|
-
1. Get ads from 5 competitors
|
|
256
|
-
2. Map their positioning
|
|
257
|
-
3. Find underserved angles
|
|
258
|
-
4. Develop differentiated messaging
|
|
259
|
-
5. Test against their approaches
|
|
260
|
-
|
|
261
|
-
### Creative Inspiration
|
|
262
|
-
1. Extract ads by theme
|
|
263
|
-
2. Analyze visual patterns
|
|
264
|
-
3. Note color and layout trends
|
|
265
|
-
4. Adapt successful patterns
|
|
266
|
-
5. Create original variations
|
|
267
|
-
|
|
268
|
-
## Tips for Success
|
|
269
|
-
|
|
270
|
-
1. **Regular Monitoring**: Check monthly for changes
|
|
271
|
-
2. **Broad Research**: Look at adjacent competitors too
|
|
272
|
-
3. **Save Everything**: Build a reference library
|
|
273
|
-
4. **Test Insights**: Run your own experiments
|
|
274
|
-
5. **Track Performance**: A/B test inspired concepts
|
|
275
|
-
6. **Stay Original**: Use for inspiration, not copying
|
|
276
|
-
7. **Multiple Platforms**: Compare Facebook, LinkedIn, TikTok, etc.
|
|
277
|
-
|
|
278
|
-
## Output Formats
|
|
279
|
-
|
|
280
|
-
- **Screenshots**: All ads saved as images
|
|
281
|
-
- **Analysis Report**: Markdown summary of insights
|
|
282
|
-
- **Spreadsheet**: CSV with ad copy, CTAs, themes
|
|
283
|
-
- **Presentation**: Visual deck of top performers
|
|
284
|
-
- **Pattern Library**: Categorized by approach
|
|
285
|
-
|
|
286
|
-
## Related Use Cases
|
|
287
|
-
|
|
288
|
-
- Writing better ad copy for your campaigns
|
|
289
|
-
- Understanding market positioning
|
|
290
|
-
- Finding content gaps in your messaging
|
|
291
|
-
- Discovering new use cases for your product
|
|
292
|
-
- Planning product marketing strategy
|
|
293
|
-
- Inspiring social media content
|
|
294
|
-
|