diff --git a/.github/workflows/claude-code-review.yml b/.github/workflows/claude-code-review.yml index 7898434..834714b 100644 --- a/.github/workflows/claude-code-review.yml +++ b/.github/workflows/claude-code-review.yml @@ -22,7 +22,7 @@ jobs: - name: Run Claude Code Review id: claude-review - uses: anthropics/claude-code-action@v1.0.88 + uses: anthropics/claude-code-action@v1 with: claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }} use_sticky_comment: true diff --git a/README.md b/README.md index 7ea0b90..8b477c3 100644 --- a/README.md +++ b/README.md @@ -25,28 +25,30 @@ Install the skills from https://github.com/exiao/skills | Skill | Description | |-------|-------------| -| [article-writer](article-writer/) | Write article drafts from approved outlines with SEO and brand voice | -| [brand-identity](brand-identity/) | Build a complete brand identity: purpose, values, voice, visual system, guidelines | -| [content-pipeline](content-pipeline/) | Orchestrator for the 3-article content pipeline with parallel sub-agents | -| [content-strategy](content-strategy/) | Build content strategy: hooks, angles, and ideas from what's trending now | -| [editor-in-chief](editor-in-chief/) | Autonomous editing orchestrator: diagnose, fix, and iterate drafts to quality | -| [evaluate-content](evaluate-content/) | Judge content quality: shareability, readability, voice, cuttability, angle | -| [hooks](hooks/) | Generate headlines, titles, and scroll-stopping openers | -| [outline-generator](outline-generator/) | Generate structured article outlines from approved hooks | -| [substack-draft](substack-draft/) | Save finished articles to Substack as drafts | -| [tweet-ideas](tweet-ideas/) | Generate standalone tweet ideas (Aaron Levie playbook) | +| [copywriting](copywriting/) | Page copy frameworks + direct response for any platform (ads, App Store, landing pages, scripts). | +| [article-writer](article-writer/) | write article drafts from approved outlines with SEO and brand voice. | +| [content-strategy](content-strategy/) | Build content strategy from trending hooks, angles, and ideas across TikTok, X, YouTube, Meta, and LinkedIn. | +| [editor-in-chief](editor-in-chief/) | autonomous editing orchestrator: diagnose, fix, and iterate drafts to quality. | +| [evaluate-content](evaluate-content/) | judge content quality: shareability, readability, voice, cuttability, angle. | +| [hooks](hooks/) | generate hooks, titles, and scroll-stopping openers for content. | +| [outline-generator](outline-generator/) | generate structured article outlines from approved headlines. | +| [substack-draft](substack-draft/) | save finished articles to Substack as drafts. | +| [tweet-ideas](tweet-ideas/) | generate standalone tweet ideas about a topic (Aaron Levie playbook). | +| [video-script](video-script/) | Generate structured scene-by-scene video scripts with production metadata ready for the video-production pipeline. | +| [writer](writer/) | Write content in Eric's voice — articles, blog posts, tweets, social media posts, marketing copy, newsletter drafts. | +| [document-release](document-release/) | Update all project documentation to match what was just shipped — catch stale READMEs and drifted docs after a release. | ### Marketing & Growth | Skill | Description | |-------|-------------| | [aso](aso/) | App Store Optimization: keyword research, audits, metadata, competitor analysis via DataForSEO | -| [cold-email](cold-email/) | B2B cold email writing and follow-up sequences | +| [churn-prevention](churn-prevention/) | Reduce churn: cancellation flows, save offers, retention strategies, dunning, win-back sequences. | | [competitive-analysis](competitive-analysis/) | Research competitors and build interactive battlecards | | [content-performance-report](content-performance-report/) | Weekly content pillar performance report (cron) | | [copywriting](copywriting/) | Write or improve marketing copy for any surface: pages, ads, app stores, landing pages, video scripts, push notifications. Combines page copy frameworks with direct response principles. | | [dogfood](dogfood/) | QA and exploratory test web applications, produce structured reports | -| [launch-strategy](launch-strategy/) | Product launches, feature announcements, Product Hunt, go-to-market | +| [email-sequence](email-sequence/) | Create and optimize email sequences, drip campaigns, onboarding flows, and lifecycle messaging. | | [market-daily-briefing](market-daily-briefing/) | Daily market briefing: earnings, macro, notable moves (cron) | | [marketing-psychology](marketing-psychology/) | Psychological principles, mental models, and behavioral science for marketing | | [meta-ads](meta-ads/) | Daily Meta ad operations via Marketing API | @@ -58,11 +60,18 @@ Install the skills from https://github.com/exiao/skills | [synthetic-userstudies](synthetic-userstudies/) | Run synthetic user research sessions with AI personas | | [typefully](typefully/) | Create, schedule, and manage social posts via Typefully | | [whop-content-rewards](whop-content-rewards/) | Set up and manage UGC campaigns on Whop | +| [brand-identity](brand-identity/) | Build a complete brand identity from scratch or refresh an existing one — purpose, values, voice, visual identity system, and brand guidelines. | +| [content-pipeline](content-pipeline/) | Orchestrator for the 3-article content pipeline — research phase, parallel article sub-agents, Typefully drafts. | +| [post-bloom-features](post-bloom-features/) | Cron: screenshot Bloom feature PRs in iOS simulator, render Remotion video, create Typefully draft, report to Signal. | +| [post-insider-trades](post-insider-trades/) | Cron: scrape OpenInsider for significant insider buys, generate trade card, write tweet, create Typefully draft. | +| [post-investinglog-trades](post-investinglog-trades/) | Cron: pick best unposted trade from investing-log, generate trade card, create Typefully draft. | +| [earnings-card-pipeline](earnings-card-pipeline/) | Cron: pull weekly major earnings events, generate sticker-style cards, create Typefully drafts, report to Signal. | ### Design & Visual | Skill | Description | |-------|-------------| +| [impeccable](impeccable/) | Run design quality commands on frontend code — audit, critique, polish, animate, normalize, and more. 21 steering commands and 7 reference files. | | [visual-design](visual-design/) | Router skill for all visual design tasks (dispatches to sub-skills below) | | [visual-design/canvas-design](visual-design/canvas-design/) | Create visual art and designs as .png/.pdf files | | [visual-design/create-a-sales-asset](visual-design/create-a-sales-asset/) | Generate sales assets: landing pages, decks, one-pagers | @@ -74,7 +83,7 @@ Install the skills from https://github.com/exiao/skills | [design-review](design-review/) | Product design review: 13 questions + Nielsen Norman heuristic eval | | [nano-banana-pro](nano-banana-pro/) | Generate or edit images via Gemini native image generation | | [excalidraw-mcp](excalidraw-mcp/) | Create hand-drawn style diagrams via Excalidraw MCP | -| [impeccable](impeccable/) | Design quality layer: 21 commands (audit, critique, polish, animate, etc.) with 10 reference files for systematic frontend QA | +| [impeccable](impeccable/) | Design quality commands for frontend code: audit, critique, polish, animate, normalize | ### Video Production @@ -109,6 +118,9 @@ Install the skills from https://github.com/exiao/skills | [stock-research](stock-research/) | Stock/equity research, earnings analysis, daily market briefings | | [trend-research](trend-research/) | Find trending content across TikTok, YouTube, Instagram, X | | [web-search](web-search/) | Search the web via Serper (Google Search) API | +| [another-perspective](another-perspective/) | Multi-perspective council analysis on any question, plan, or decision — spawns parallel cognitive perspectives and synthesizes via structured dialectical analysis. | +| [last30days](last30days/) | Research what happened in the last 30 days on any topic. Sources: Reddit, X, YouTube, web. Produces expert-level summary. | +| [trip-planner](trip-planner/) | Generate detailed day-by-day travel itineraries with neighborhood routing, budget scaling, and dietary-aware meal picks. | ### Advertising @@ -145,100 +157,59 @@ Install the skills from https://github.com/exiao/skills | [superpowers-coding](superpowers-coding/) | TDD-first feature implementation and systematic debugging | | [superpowers-planning](superpowers-planning/) | Explore intent and create detailed plans before touching code | | [superpowers-reviews](superpowers-reviews/) | Code review, branch finishing, batch execution with checkpoints | -| [verify-deploy](verify-deploy/) | Post-merge deploy verification and production benchmarking | +| [verify-deploy](verify-deploy/) | Post-merge deploy verification and production benchmarking. | +| [alpaca](alpaca/) | Trade stocks and crypto via Alpaca API — market data, quotes, orders, positions, portfolio management. Supports paper and live trading. | +| [app-store-screenshots](app-store-screenshots/) | Generate production-ready App Store marketing screenshots for iOS apps using a Next.js generator at all 4 Apple-required sizes. | +| [cloud-migration](cloud-migration/) | Execute full cloud provider migrations end-to-end — provision, migrate data, transfer secrets, deploy, verify, cut over DNS, and clean up. | +| [codex](codex/) | Get a second opinion from OpenAI Codex CLI — code review, adversarial challenge, or open consultation. | +| [openclaw-memory-setup](openclaw-memory-setup/) | Set up a complete memory system for an OpenClaw instance — workspace files, vector search, compaction, heartbeat memory maintenance. | +| [openclaw-resiliency](openclaw-resiliency/) | Set up a gateway watchdog for OpenClaw health with auto-recovery — 3-tier health checks, exponential backoff, launchd/systemd integration. | +| [porkbun](porkbun/) | Manage Porkbun domains, DNS records, SSL certificates, URL forwarding, and hosting blueprints via the Porkbun API. | +| [railway](railway/) | Deploy, manage, and operate Railway projects via CLI and MCP — services, databases, env vars, logs, domains. | +| [remotion-best-practices](remotion-best-practices/) | Best practices for writing Remotion code — compositions, animations, captions, audio, charts, 3D, fonts, transitions. | +| [render-cli](render-cli/) | Manage Render.com services, deploys, databases, logs, and infrastructure using the official Render CLI. | +| [security-audit](security-audit/) | Run a codebase security audit using OWASP Top 10 and STRIDE threat modeling. | +| [skill-audit](skill-audit/) | Audit and score any skill against best practices — structure, content, patterns, scorecard with specific fixes. | +| [skill-creator](skill-creator/) | Create and improve skills — TDD pre-flight, evals, benchmarking, performance analysis, description optimization. | +| [skill-improver](skill-improver/) | Autonomously optimize any skill by running evals, scoring outputs, mutating the prompt, and keeping improvements. | +| [stock-footage](stock-footage/) | Search and download free stock video footage from Pexels and Pixabay for B-roll and video production. | +| [userinterface-wiki](userinterface-wiki/) | UI/UX best practices for web interfaces — animations, CSS, typography, UX patterns, prefetching, icons. | +| [video-editor](video-editor/) | Programmatic video editing via ffmpeg CLI — trim, merge, overlay, crossfade, speed ramp, crop, scale, audio, text, GIF. | ### Strategy & Business | Skill | Description | |-------|-------------| -| [alpaca](alpaca/) | Trade stocks and crypto via Alpaca API | -| [another-perspective](another-perspective/) | Multi-perspective council analysis on decisions | -| [cloud-migration](cloud-migration/) | Full cloud provider migrations end-to-end | -| [porkbun](porkbun/) | Manage domains, DNS, SSL via Porkbun API | -| [railway](railway/) | Deploy and manage Railway projects via CLI and MCP | -| [render-cli](render-cli/) | Deploy and manage Render services via official Render CLI | -| [sahil-office-hours](sahil-office-hours/) | Startup advice frameworks from Sahil Lavingia (Gumroad) | -| [yc-office-hours](yc-office-hours/) | YC office hours prep | - -### OpenClaw & Infrastructure - -| Skill | Description | -|-------|-------------| -| [openclaw-memory-setup](openclaw-memory-setup/) | Set up a complete memory system for an OpenClaw instance | -| [openclaw-resiliency](openclaw-resiliency/) | Gateway watchdog for health monitoring and auto-recovery | -| [security-audit](security-audit/) | Security audit for codebases and deployments | - -### Automated Pipelines (Cron) - -| Skill | Description | -|-------|-------------| -| [earnings-card-pipeline](earnings-card-pipeline/) | Weekly earnings event cards for social (Mon 8 AM ET) | -| [post-bloom-features](post-bloom-features/) | Screenshot new features, render social cards (Tue/Thu 1 AM ET) | -| [post-insider-trades](post-insider-trades/) | Scrape insider buys, generate trade cards (weekdays 9 AM + 2 PM ET) | -| [post-investinglog-trades](post-investinglog-trades/) | Post trade cards from investing-log (weekdays 4 PM ET) | - -### UI/UX - -| Skill | Description | -|-------|-------------| -| [userinterface-wiki](userinterface-wiki/) | UI/UX best practices: animations, CSS, typography, UX patterns | - -### Other - -| Skill | Description | -|-------|-------------| -| [document-release](document-release/) | Document release processes | -| [trip-planner](trip-planner/) | Generate day-by-day travel itineraries with neighborhood routing and budget scaling | - ---- - -## Adapted Skills - -These started from other open-source projects. I've modified and extended them for my workflows. Links to the originals: - -### From [Anthropic](https://github.com/anthropics) - -| Skill | Original | -|-------|----------| -| [documents](documents/) | [anthropics/skills](https://github.com/anthropics/skills) | -| [wealth-management](wealth-management/) | [anthropics/financial-services-plugins](https://github.com/anthropics/financial-services-plugins) | -| [skill-creator](skill-creator/) | [anthropics/claude-code](https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev) | -| [skill-audit](skill-audit/) | Original (inspired by Anthropic's skill patterns) | -| [skill-improver](skill-improver/) | [anthropics/claude-code](https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev) | -| [visual-design/frontend-design](visual-design/frontend-design/) | [anthropics/claude-code](https://github.com/anthropics/claude-code/tree/main/plugins/frontend-design) | -| [ralph-mode](ralph-mode/) | [anthropics/claude-code](https://github.com/anthropics/claude-code/tree/main/plugins/ralph-wiggum) | - -### From [obra/superpowers](https://github.com/obra/superpowers) +| [marketing-psychology](marketing-psychology/) | Psychological principles, mental models, and behavioral science for marketing. | +| [pricing-strategy](pricing-strategy/) | Pricing decisions, tier packaging, value metrics, monetization strategy. | +| [launch-strategy](launch-strategy/) | Product launches, feature announcements, Product Hunt, go-to-market. | +| [paid-ads](paid-ads/) | Paid advertising strategy: platform selection, targeting, creative, optimization. | +| [referral-program](referral-program/) | Referral and affiliate program design, optimization, and measurement. | +| [cold-email](cold-email/) | B2B cold email writing and follow-up sequences. | +| [product-marketing-context](product-marketing-context/) | Create product marketing context doc referenced by all marketing skills. | +| [create-a-sales-asset](visual-design/create-a-sales-asset/) | generate sales assets (landing pages, decks, one-pagers). | +| [dogfood](dogfood/) | QA and exploratory test web applications, produce structured reports. | +| [growth](growth/) | full-funnel growth: CRO, onboarding, paywalls, churn, launches, pricing. | +| [positioning-angles](positioning-angles/) | define product positioning angles and strategic frames. | +| [wealth-management](wealth-management/) | client reviews, financial plans, investment proposals, portfolio rebalancing, tax-loss harvesting. | +| [sahil-office-hours](sahil-office-hours/) | Startup advice frameworks from Sahil Lavingia (Gumroad) — the minimalist entrepreneur lens for business decisions. | +| [yc-office-hours](yc-office-hours/) | Product discovery via YC-style forcing questions and 10-star product thinking. Use when starting a new feature or evaluating an idea. | + +## Installation + +Skills live in your OpenClaw skills directory. Clone and point your config: + +```bash +git clone https://github.com/exiao/skills ~/clawd/skills +``` -| Skill | Description | -|-------|-------------| -| [superpowers-coding](superpowers-coding/) | TDD-first feature implementation and systematic debugging | -| [superpowers-planning](superpowers-planning/) | Explore intent and create detailed plans before touching code | -| [superpowers-reviews](superpowers-reviews/) | Code review, branch finishing, batch execution with checkpoints | +Or grab individual skills: -### From [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) +```bash +cp -r ~/path/to/skills/ad-copy ~/clawd/skills/ +``` -| Skill | Description | -|-------|-------------| -| [growth](growth/) | Full-funnel growth: CRO, onboarding, paywalls, churn, launches, pricing | -| [churn-prevention](churn-prevention/) | Subscription retention, cancel flows, save offers, dunning | -| [email-sequence](email-sequence/) | Email sequences, drip campaigns, lifecycle messaging | -| [positioning-angles](positioning-angles/) | Product positioning, strategic angles, value propositions | - -### From Other Projects - -| Skill | Original | -|-------|----------| -| [codex](codex/) | [garrytan/gstack](https://github.com/garrytan/gstack) (MIT) | -| [impeccable](impeccable/) | [pbakaus/impeccable](https://github.com/pbakaus/impeccable) | -| [app-store-screenshots](app-store-screenshots/) | [ParthJadhav/app-store-screenshots](https://github.com/ParthJadhav/app-store-screenshots) | -| [remotion-best-practices](remotion-best-practices/) | [remotion-dev/skills](https://github.com/remotion-dev/skills) | -| [video-production/remotion-videos](video-production/remotion-videos/) | [remotion-dev/skills](https://github.com/remotion-dev/skills) | -| [visual-design/frontend-slides](visual-design/frontend-slides/) | [zarazhangrui/frontend-slides](https://github.com/zarazhangrui/frontend-slides) | -| [last30days](last30days/) | [mvanhorn/last30days-skill](https://github.com/mvanhorn/last30days-skill) | -| [stably-cli](stably-cli/) | [skills.sh/stablyai](https://skills.sh/stablyai/agent-skills/stably-cli) | -| [stably-sdk-rules](stably-sdk-rules/) | [skills.sh/stablyai](https://skills.sh/stablyai/agent-skills/stably-sdk-rules) | -| [sahil-office-hours](sahil-office-hours/) | [slavingia/skills](https://github.com/slavingia/skills) | +Each skill is a folder with a `SKILL.md` file. OpenClaw auto-discovers them at startup. ## License diff --git a/content-strategy/SKILL.md b/content-strategy/SKILL.md index 94602a9..d7c367e 100644 --- a/content-strategy/SKILL.md +++ b/content-strategy/SKILL.md @@ -174,7 +174,7 @@ Source: @thebranding.ai breakdown of multiple creators going viral with the same 3. Deliver value through speech while the visual activity anchors attention 4. Close with soft CTA or open loop -**Example application:** Film hands writing stock tickers on a notepad, scrolling through [Your App], or organizing investment notes while delivering investing insights via voiceover. +**Bloom application:** Film hands writing stock tickers on a notepad, scrolling through the Bloom app, or organizing investment notes while delivering investing insights via voiceover. | Audience Temp | Best Formats | |--------------|-------------| @@ -272,7 +272,7 @@ This is a full account pillar — not a one-off format. Run it every week. Place labels at the moment you identify the tactic, not before. Let the source video play 2-3 seconds first, then drop the label as your "aha" moment. Use bold white or colored text, large enough to read on mobile, centered or near the source video panel. -**Example (investing niche):** +**Bloom-specific example:** - Source: viral TikTok of someone showing their Robinhood portfolio down 40% (2M+ views) - Labels you'd drop: "LOSS AVERSION" (the emotional hook), "ROUND NUMBER" (they lost exactly $10K, not $9,847), "SCREENSHOT FORMAT" (looks organic, not produced), "NO CTA" (the virality IS the content, no ask) - Your commentary: explain each label as an investing psychology + content strategy concept simultaneously. Double value for the viewer. @@ -462,7 +462,56 @@ The hierarchy: **Posting > Targeting > Platform choice > Repurposing > Scripting --- -> **Load on-demand:** `references/channel-playbook.md` for channel tier list, quiz funnel strategy, and SEO timing. +## Channel Tier List (Bloom / B2C) + +What actually works for consumer apps vs. what sounds good but doesn't. + +**High-signal channels:** +- TikTok / Instagram Reels — primary B2C organic discovery; recreate before recruiting creators +- Influencer/creator marketing — TikTok/YouTube/Instagram. Lovable ($400M ARR) spends 10x more on influencer marketing than paid social and considers it their key growth driver. Validate formats with your own account first, then hand proven formats to creators. This should be the primary paid channel, not Meta ads. +- Free credits / freemium as marketing — treat free tier as a marketing channel, not a cost center. "Our free giveaways are bigger than paid marketing spend." (Lovable CEO, 20VC March 2026) +- Free SEO tools — high-value lead magnets, easier to rank than blog posts, builds backlinks +- Email marketing — works if sequences are built correctly (see growth skill); people do read emails + +**Questionable-signal channels (test carefully):** +- Meta/Facebook ads — Lovable's CEO at $400M ARR: "Meta ads have little incrementality; pass through views which don't materialize into anything. I haven't seen them work in a while." (Lenny's Podcast, Dec 2025). If running Meta ads, watch incrementality closely: are installs you're paying for ones that would have happened organically? Compare install lift when ads are paused vs. running. + +**Low-signal channels (avoid or deprioritize):** +- Newsletter sponsorships — expensive and most clicks are bots +- Twitter ads — worst targeting in the industry; not worth the spend +- Google ads — more expensive than Facebook for consumer apps, higher irrelevant clicks +- Referral programs — very hard to make work; only viable with stable conversion and large customer base +- Reddit audience building — ban risk is high; answering long-tail questions can work, but building an audience there doesn't +- Beta directories (BetaList, etc.) — mostly dead; not worth the setup + +**Alternative funnel: Quiz-based landing pages** + +Instead of Ad → App Store → Install, run Ad → Web Quiz → Personalized Results → App Store. A quiz between the ad and the offer warms cold traffic through micro-commitments. DTC benchmark: cold traffic conversion jumped from 1.2% to 4.7% with a quiz funnel (@DTC_Quizbuilder, $2M in 90 days). + +Why it works for apps: +- Each question answered is a small "yes" that compounds (sunk cost) +- Questions seed beliefs and pre-handle objections before the user sees pricing +- Non-completers give you zero-party data for segmented retargeting (someone who answered "I struggle with timing the market" gets a different retargeting ad than someone who answered "I don't know what to invest in") +- The loading/results screen is captive attention: 10-15s where you show testimonials, social proof, and app previews while "calculating their results" + +Quiz sequencing that converts: +1. Q1-Q2: Low-friction demographics (age, experience level). Zero cognitive load, starts the yes-chain. +2. Q3-Q4: Aspirational goals ("What's your investing goal?"). Emotional questions hit harder after they've committed. +3. Q5-Q6: Pain points and struggles. Now they've told you their problems. +4. Breather slide with social proof after Q4. +5. Results page → personalized app recommendation → App Store link. + +Drop-off benchmarks: Q1 = 30-40% drop-off (normal, biggest filter). Remaining questions: under 15% each. Overall completion: aim for 25%+. If any single question has 10%+ drop-off, simplify it (fewer options, add "None of the above"). + +Retargeting play: Everyone who takes the quiz but doesn't install gave you data. Segment retargeting by their answers: "tried other investing apps" → ad about why Bloom's AI is different. "Low confidence in stock picks" → ad about AI-powered research. Specific beats generic. + +Bloom application: The onboarding flow already asks risk tolerance and goals post-install. A pre-install web quiz version of this would warm traffic before the App Store page, and the data feeds retargeting even if they never install. + +Source: @DTC_Quizbuilder thread (https://x.com/DTC_Quizbuilder/status/2010379560769015885) + +**SEO timing:** +- Don't prioritize SEO before your first customers — takes months to kick in, and if you pivot the product, the work goes to zero +- When you do SEO: free tools first (easier to rank, more shareable, generate backlinks naturally), then long-tail blog posts with purchase intent, then programmatic data-driven pages --- diff --git a/copywriting/SKILL.md b/copywriting/SKILL.md index c5155da..b96f502 100644 --- a/copywriting/SKILL.md +++ b/copywriting/SKILL.md @@ -1,8 +1,6 @@ --- name: copywriting -description: "Write or improve marketing copy for any surface: pages, ads, app stores, landing pages, Google Ads, TikTok/Meta scripts, push notifications, email campaigns, UGC. Use when the user needs ad copy, ad headlines, conversion-focused text, A/B test variants, landing page text, or page copy. Combines page copy frameworks with direct response principles." -metadata: - version: 1.0.0 +description: "Write or improve marketing copy for any surface: pages, ads, app stores, landing pages, TikTok/Meta scripts, push notifications, UGC. Combines page copy frameworks with direct response principles." --- # Copywriting diff --git a/copywriting/references/7-ugc-script-templates.md b/copywriting/references/7-ugc-script-templates.md index b649549..227840b 100644 --- a/copywriting/references/7-ugc-script-templates.md +++ b/copywriting/references/7-ugc-script-templates.md @@ -4,7 +4,7 @@ Script structures for AI-generated UGC testimonials. ## AI UGC Production Stack -Before scripting, build the production infrastructure. For the full UGC campaign setup (creator sourcing, content rewards, distribution), see the `whop-content-rewards` skill. Summary: +Before scripting, build the production infrastructure. Summary: **1. Find a reference ad first** - Use [Meta Ad Library](https://facebook.com/ads/library) or [GetHooked.ai](https://gethooked.ai) — find ads in your category running 30+ days (run duration = proof of return) diff --git a/copywriting/references/natural-transitions.md b/copywriting/references/natural-transitions.md index 4cc7287..62f7c7c 100644 --- a/copywriting/references/natural-transitions.md +++ b/copywriting/references/natural-transitions.md @@ -268,5 +268,3 @@ These phrases are overused in AI-generated content: - "When it comes to the realm of..." - "This begs the question..." - "Let's delve into..." - -Refer to the seo-research skill for AI writing detection patterns. diff --git a/copywriting/references/references.md b/copywriting/references/references.md index b5035e2..209474d 100644 --- a/copywriting/references/references.md +++ b/copywriting/references/references.md @@ -2,7 +2,6 @@ | File | Contents | |------|----------| -| `references/copy-frameworks.md` | Headline formulas, page section types, and structural templates for page copy | +| `references/copy-frameworks.md` | 14 proven copywriting frameworks (PAS, AIDA, BAB, FAB, ACCA, STAR, etc.) with detailed structures, selection matrix by platform/goal, and when-to-use guidance | | `references/writing-styles.md` | Voice and tone rules from Ogilvy, Schwartz, Hopkins, Halbert, Sugarman, Caples, Collier. Contains banned phrases list, AI tell patterns, and how human copy sounds. | -| `references/direct-response-frameworks.md` | Extended direct response formulas, long-form copy structures, and classic frameworks (PAS, AIDA, BAB, FAB, ACCA, STAR, etc.) | | `references/lead-magnet-patterns.md` | Lead magnet post structures, value framing techniques, CTA patterns for social giveaway posts | diff --git a/evaluate-content/SKILL.md b/evaluate-content/SKILL.md index 168da93..30f336f 100644 --- a/evaluate-content/SKILL.md +++ b/evaluate-content/SKILL.md @@ -473,6 +473,66 @@ Use these for faster reviews when a full seven-sweep process isn't needed. | Seamless | Smooth | | Cutting-edge | New/Modern | +### Plain English Alternatives + +Replace complex or pompous words with simpler ones. Source: Plain English Campaign, plainlanguage.gov. + +| Complex | Plain | +|---------|-------| +| absence of | no, none | +| accomplish | do, finish | +| additional | extra, more | +| advise | tell, say | +| allocate | give, share | +| anticipate | expect | +| approximately | about | +| ascertain | find out | +| assistance | help | +| at the present time | now | +| cease | stop, end | +| commence | start, begin | +| communicate | tell, talk | +| consequently | so | +| currently | now | +| demonstrate | show, prove | +| determine | decide | +| discontinue | stop | +| disseminate | spread | +| due to the fact that | because | +| endeavour | try | +| establish | set up, show | +| expedite | speed up | +| facilitate | help | +| for the purpose of | to, for | +| furthermore | also, and | +| implement | carry out, do | +| in accordance with | under | +| in conjunction with | with | +| in order to | to | +| in the event of | if | +| indicate | show, suggest | +| initiate | start, begin | +| moreover | also, and | +| notify | tell | +| obtain | get | +| on behalf of | for | +| owing to | because | +| permit | let, allow | +| prior to | before | +| procure | get | +| provide | give | +| purchase | buy | +| regarding | about | +| reimburse | repay | +| require | need | +| retain | keep | +| subsequently | later | +| sufficient | enough | +| terminate | end, stop | +| utilise | use | + +**Phrases to remove entirely:** "a total of," "absolutely," "actually," "at the end of the day," "at this moment in time," "basically," "I am of the opinion that" (use "I think"), "in the final analysis," "it should be understood," "last but not least," "obviously," "of course," "quite," "really," "the fact of the matter is," "to all intents and purposes," "very." + **Watch for:** - Adverbs (usually unnecessary) - Passive voice (switch to active) diff --git a/fix-bloom-prs/SKILL.md b/fix-bloom-prs/SKILL.md index e9e8364..832d8ab 100644 --- a/fix-bloom-prs/SKILL.md +++ b/fix-bloom-prs/SKILL.md @@ -51,9 +51,6 @@ The #1 failure mode is pushing speculative fixes that trigger new CI runs, new r ## Circuit Breakers -> **Note:** `$REPO` below refers to the repo slug from preflight output (e.g. `bloom-invest/bloom`). It is set explicitly in the Triage step. - - **Repeat fix detection:** Before fixing, check if the last commit on the PR was from a previous cron run (author = "claude" or commit message matches cron fix patterns). If the cron already pushed a fix and the issue persists, the fix didn't work. Comment explaining what you tried and what's still broken. Do not retry the same approach. **CI-only failures:** If the only issue is a CI failure that looks infrastructure-related (timeout, runner error, network issue, flaky test), re-request the check run instead of pushing code. Use: `gh api repos/$REPO/actions/runs/{run_id}/rerun-failed-jobs -X POST` diff --git a/impeccable/SKILL.md b/impeccable/SKILL.md index ee5d64d..49cde6c 100644 --- a/impeccable/SKILL.md +++ b/impeccable/SKILL.md @@ -1,6 +1,6 @@ --- name: impeccable -description: Run impeccable design quality commands on frontend code — audit, critique, polish, animate, normalize, and more. Built on top of the frontend-design skill with 21 steering commands and 10 domain-specific reference files. Use when doing a design QA pass, reviewing UI quality, or refining a frontend component before shipping. +description: Run impeccable design quality commands on frontend code — audit, critique, polish, animate, normalize, and more. Built on top of the frontend-design skill with 21 steering commands and 7 domain-specific reference files. Use when doing a design QA pass, reviewing UI quality, or refining a frontend component before shipping. --- > **Source:** External skill (frontend-design ecosystem) — local copy, do not modify without checking upstream. @@ -10,7 +10,7 @@ description: Run impeccable design quality commands on frontend code — audit, Design quality layer for Claude Code. 21 commands that audit, review, polish, and refine frontend interfaces. Complements the `frontend-design` skill (vision/direction) with systematic QA passes. **Source:** https://github.com/pbakaus/impeccable -**Installed at:** `~/clawd/skills/` (frontend-design + 21 individual command skills) +**Installed at:** `~/clawd/skills/` (frontend-design + 7 individual command skills) ## When to Use diff --git a/impeccable/commands/teach-impeccable/SKILL.md b/impeccable/commands/teach-impeccable/SKILL.md index c51de3b..96f31fe 100644 --- a/impeccable/commands/teach-impeccable/SKILL.md +++ b/impeccable/commands/teach-impeccable/SKILL.md @@ -64,6 +64,8 @@ Synthesize your findings and the user's answers into a `## Design Context` secti [3-5 principles derived from the conversation that should guide all design decisions] ``` -Write this section to `.impeccable.md` in the project root. If the file already exists, update the Design Context section in place. Then STOP and call the AskUserQuestion tool to clarify whether they'd also like the Design Context appended to CLAUDE.md. If yes, append or update the section there as well. +Write this section to `.impeccable.md` in the project root. If the file already exists, update the Design Context section in place. + +Then STOP and call the AskUserQuestion tool to clarify. whether they'd also like the Design Context appended to CLAUDE.md. If yes, append or update the section there as well. Confirm completion and summarize the key design principles that will now guide all future work. \ No newline at end of file diff --git a/marketing-psychology/SKILL.md b/marketing-psychology/SKILL.md index 969a733..349d912 100644 --- a/marketing-psychology/SKILL.md +++ b/marketing-psychology/SKILL.md @@ -157,16 +157,6 @@ Study failed campaigns, not just successful ones. The viral hit you're copying h | Decision paralysis | Paradox of Choice, Default Effect, Nudge Theory | | Onboarding | Goal-Gradient, IKEA Effect, Commitment & Consistency | -## Model Definitions - -Brief descriptions for models referenced above without dedicated sections: - -- **Hick's Law**: More choices = longer decision time. Reduce options to speed up conversions. -- **Activation Energy**: The effort required to start an action. Lower activation energy (fewer clicks, pre-filled forms) to increase uptake. -- **Default Effect**: People stick with pre-selected defaults. Set smart defaults that serve both user and business goals. -- **Nudge Theory**: Small environmental changes guide behavior without restricting choices. Surface the desired action where attention already is. -- **Local vs Global Optima**: Optimizing one part of the funnel can hurt overall performance. Evaluate changes against the full-funnel metric, not just the step being changed. - --- ## Related Skills diff --git a/meta-ads/SKILL.md b/meta-ads/SKILL.md index 23ab551..39a2f2a 100644 --- a/meta-ads/SKILL.md +++ b/meta-ads/SKILL.md @@ -12,7 +12,7 @@ Daily 4am routine: audit running ads via Meta Marketing API, kill underperformer ## API Credentials ```bash -TOKEN="$META_ACCESS_TOKEN" # Meta Marketing API token +TOKEN=$META_ACCESS_TOKEN # Meta Marketing API token ACCOUNT="$BLOOM_AD_ACCOUNT_ID" # Bloom ad account (act_...) API="https://graph.facebook.com/v22.0" PAGE_ID="$BLOOM_PAGE_ID" # Facebook Page ID diff --git a/paid-ads/SKILL.md b/paid-ads/SKILL.md index f9c881c..873c5eb 100644 --- a/paid-ads/SKILL.md +++ b/paid-ads/SKILL.md @@ -61,7 +61,7 @@ Account ### Naming Convention ``` [Platform]_[Objective]_[Audience]_[Offer]_[Date] -META_Conv_Lookalike-Customers_FreeTrial_YYYY_Q1 +META_Conv_Lookalike-Customers_FreeTrial_2024Q1 ``` ### Budget Allocation diff --git a/product-marketing-context/SKILL.md b/product-marketing-context/SKILL.md index f47b547..9bd90b7 100644 --- a/product-marketing-context/SKILL.md +++ b/product-marketing-context/SKILL.md @@ -167,6 +167,7 @@ Show the completed document, ask for adjustments, save to `.agents/product-marke ## Related Skills -- **competitive-analysis**: For deeper competitive research and battlecards +- **competitive-analysis**: For deeper competitive research +- **brand-identity**: For visual and verbal brand identity - **positioning-angles**: For positioning framework development - **copywriting**: For writing copy using this context diff --git a/ralph-mode/SKILL.md b/ralph-mode/SKILL.md index 746a7fd..ce30f48 100644 --- a/ralph-mode/SKILL.md +++ b/ralph-mode/SKILL.md @@ -152,12 +152,64 @@ sessions_spawn({ The plugin must be installed in the target project first. -## Philosophy +## Self-Loop Protocol (OpenClaw) -1. **Iteration > Perfection**: Don't aim for perfect on first try. Let the loop refine. -2. **Failures Are Data**: "Deterministically bad" means failures are predictable. Use them to tune prompts. -3. **Operator Skill Matters**: Success depends on writing good prompts, not just having a good model. -4. **Persistence Wins**: Keep trying until success. +OpenClaw doesn't have post-completion hooks like Claude Code. Instead, the loop lives in the agent's behavior. When Ralph Mode is active, follow this protocol at the end of every turn: + +### After completing any work: + +1. **Re-read** `IMPLEMENTATION_PLAN.md` +2. **Count** remaining incomplete tasks +3. **If tasks remain AND iteration < max:** + - Pick the next highest-priority incomplete task + - Implement it (one task only) + - Run backpressure gates + - Update the plan + - Commit + - Go to step 1 +4. **If all tasks complete OR max iterations reached:** + - Run final validation (all gates) + - Emit the completion signal: `█RALPH_COMPLETE█` + - Stop + +### Completion signal + +The literal string `█RALPH_COMPLETE█` signals the loop is done. Do not emit it until: +- Every task in `IMPLEMENTATION_PLAN.md` is marked done +- All backpressure gates pass +- No known blocking issues remain + +If you hit max iterations (default: 10) without completing, emit `█RALPH_TIMEOUT█` instead and list remaining tasks. + +### Why this works + +The agent continues working within a single turn, using tool calls to implement, test, and commit in sequence. Each "iteration" is a tool-call cycle within the same turn, not a separate session. Context stays fresh because each task is small. If context gets heavy, the agent spawns a sub-agent for the next batch. + +### For sub-agent mode (fresh context per iteration) + +When the task is large enough to exhaust context: + +``` +sessions_spawn({ + runtime: "subagent", + task: "Read IMPLEMENTATION_PLAN.md at [path]. Pick the next incomplete task. Implement it. Run [gates]. Update the plan. Commit. If more tasks remain, say CONTINUE. If all done, say █RALPH_COMPLETE█.", + cwd: "[repo]", + runTimeoutSeconds: 1800 +}) +``` + +The parent checks the sub-agent's output. If it says CONTINUE, spawn another. If `█RALPH_COMPLETE█`, stop. + +## Key Rules + +- **One task per iteration** — keeps context fresh, avoids drift +- **Plans are disposable** — regenerate cheaply vs. salvage stale ones +- **Lean prompts** — target ~40–60% context utilization ("smart zone") +- **Spawn sub-agents for exploration** — protect main context +- **Self-loop by default** — don't wait for the user between iterations +- **█RALPH_COMPLETE█ is the only exit** — no "seems done", no early stops + +--- ## References diff --git a/referral-program/SKILL.md b/referral-program/SKILL.md index 68d9547..521fef6 100644 --- a/referral-program/SKILL.md +++ b/referral-program/SKILL.md @@ -11,8 +11,6 @@ Expert in viral growth and referral marketing. Design and optimize programs that ## Before Starting -Read `.agents/product-marketing-context.md` for product context. - Gather this context (ask if not provided): 1. **Program Type**: Customer referral, affiliate, or both? B2B or B2C? diff --git a/seo-research/SKILL.md b/seo-research/SKILL.md index e893710..89683d4 100644 --- a/seo-research/SKILL.md +++ b/seo-research/SKILL.md @@ -319,6 +319,7 @@ For full audit checklist, read `references/seo-technical.md`. Critical items: | `references/eeat-framework.md` | Detailed E-E-A-T criteria | | `references/quality-gates.md` | Content quality thresholds | | `references/cwv-thresholds.md` | Core Web Vitals thresholds | +| `references/site-architecture.md` | Site architecture: page hierarchy, URL patterns, navigation, internal linking | | `references/keyword-seeds.md` | Bloom keyword seed list | --- diff --git a/seo-research/references/site-architecture.md b/seo-research/references/site-architecture.md index 28c74e2..97e6ba4 100644 --- a/seo-research/references/site-architecture.md +++ b/seo-research/references/site-architecture.md @@ -89,21 +89,17 @@ Users should reach any important page within 3 clicks from the homepage. If crit |----------|---------|-----------| | Header nav | Primary navigation, always visible | Top of every page | | Dropdown menus | Organize sub-pages under parent | Expands from header items | -| Mega menu | Rich dropdowns with columns/images | Large sites with many sections | | Footer nav | Secondary links, legal, sitemap | Bottom of every page | | Sidebar nav | Section navigation (docs, blog) | Left side within a section | | Breadcrumbs | Show current location in hierarchy | Below header, above content | | Contextual links | Related content, next steps | Within page content | -| Sticky/utility nav | Login, language, search | Top bar above main header | ### Header Navigation Rules -- **4-7 items max** in the primary nav (more causes decision paralysis) -- **CTA button** goes rightmost (e.g., "Start Free Trial", "Get Started") +- **4-7 items max** in the primary nav +- **CTA button** goes rightmost (e.g., "Start Free Trial") - **Logo** links to homepage (left side) - **Order by priority**: most important/visited pages first -- If mega menu, limit to 3-4 columns -- Mobile: hamburger menu with same hierarchy, CTA prominent ### Footer Organization @@ -120,92 +116,7 @@ Home > Features > Analytics Home > Blog > SEO Category > Post Title ``` -Breadcrumbs should mirror the URL hierarchy. Every segment clickable except the current page. Implement `BreadcrumbList` schema markup on all breadcrumbs. - -### Breadcrumb-URL Alignment - -The breadcrumb trail must mirror the URL path: - -| URL | Breadcrumb | -|-----|------------| -| `/features/analytics` | Home > Features > Analytics | -| `/blog/seo-guide` | Home > Blog > SEO Guide | -| `/docs/api/auth` | Home > Docs > API > Authentication | - ---- - -## Visual Sitemap Output - -### ASCII Tree Format - -Use for quick hierarchy drafts: - -``` -Homepage (/) -├── Features (/features) -│ ├── Analytics (/features/analytics) -│ ├── Automation (/features/automation) -│ └── Integrations (/features/integrations) -├── Pricing (/pricing) -├── Blog (/blog) -│ ├── [Category: SEO] (/blog/category/seo) -│ └── [Category: CRO] (/blog/category/cro) -├── Resources (/resources) -│ ├── Case Studies (/resources/case-studies) -│ └── Templates (/resources/templates) -├── Docs (/docs) -│ ├── Getting Started (/docs/getting-started) -│ └── API Reference (/docs/api) -├── About (/about) -│ └── Careers (/about/careers) -└── Contact (/contact) -``` - -### Mermaid Diagram - -Use for visual presentations and complex relationships: - -```mermaid -graph TD - subgraph Header Nav - HOME[Homepage] - FEAT[Features] - PRICE[Pricing] - BLOG[Blog] - CTA[Get Started] - end - - subgraph Footer Nav - ABOUT[About] - CAREERS[Careers] - CONTACT[Contact] - PRIVACY[Privacy] - end - - HOME --> FEAT - HOME --> PRICE - HOME --> BLOG - HOME --> ABOUT - - FEAT --> F1[Analytics] - FEAT --> F2[Automation] -``` - -**When to use which:** -- ASCII: quick drafts, text-only contexts, simple structures -- Mermaid: visual presentations, showing nav zones or linking patterns - -### URL Map Table - -For complete site planning, produce a URL map: - -| Page | URL | Parent | Nav Location | Priority | -|------|-----|--------|-------------|----------| -| Homepage | `/` | — | Header | High | -| Features | `/features` | Homepage | Header | High | -| Analytics | `/features/analytics` | Features | Header dropdown | Medium | -| Pricing | `/pricing` | Homepage | Header | High | -| Blog | `/blog` | Homepage | Header | Medium | +Breadcrumbs should mirror the URL hierarchy. Every segment clickable except the current page. ---