jfl 0.0.0

package/template/skills/x-algorithm/SKILL.md

@@ -0,0 +1,305 @@
+---
+name: x-algorithm
+description: X/Twitter For You feed ranking algorithm - optimize tweets for maximum reach
+metadata:
+  tags: twitter, x, algorithm, social, ranking, engagement
+  source: https://github.com/xai-org/x-algorithm
+---
+
+# X Algorithm Skill
+
+Optimize tweets and threads for the X (Twitter) For You feed algorithm.
+
+## How the Algorithm Works
+
+The X For You feed uses a Grok-based Phoenix transformer that predicts engagement probabilities for each tweet. No hand-engineered features—it learns entirely from engagement patterns.
+
+### The Formula
+
+```
+Final Score = Σ (weight × P(action))
+```
+
+Each tweet gets scored by predicting the probability you'll take various actions, then weighting them.
+
+### What It Predicts
+
+**Positive signals (boost score):**
+| Signal | What It Measures |
+|--------|------------------|
+| `P(favorite)` | Likelihood of like |
+| `P(reply)` | Likelihood of reply |
+| `P(repost)` | Likelihood of repost |
+| `P(quote)` | Likelihood of quote tweet |
+| `P(click)` | Likelihood of clicking through |
+| `P(profile_click)` | Likelihood of visiting author's profile |
+| `P(video_view)` | Likelihood of watching video |
+| `P(photo_expand)` | Likelihood of expanding image |
+| `P(share)` | Likelihood of sharing externally |
+| `P(dwell)` | Time spent reading/viewing |
+| `P(follow_author)` | Likelihood of following |
+
+**Negative signals (reduce score):**
+| Signal | What It Measures |
+|--------|------------------|
+| `P(not_interested)` | Likelihood of "Not interested" |
+| `P(block_author)` | Likelihood of blocking |
+| `P(mute_author)` | Likelihood of muting |
+| `P(report)` | Likelihood of reporting |
+
+### Additional Ranking Factors
+
+- **Author Diversity**: Repeated posts from same author get attenuated
+- **Out-of-Network Boost**: Discovered content (not from follows) gets special scoring
+- **Candidate Isolation**: Each tweet scored independently
+
+## Commands
+
+```
+/x-algorithm analyze [tweet]     # Score a tweet draft
+/x-algorithm optimize [tweet]    # Suggest improvements
+/x-algorithm signals             # Show all ranking signals
+/x-algorithm hooks               # Generate high-engagement hooks
+```
+
+## Usage
+
+### Analyzing a Tweet
+
+```
+/x-algorithm analyze "Just shipped a new feature"
+
+ANALYSIS:
+┌─────────────────────────────────────────────────┐
+│  Tweet: "Just shipped a new feature"            │
+├─────────────────────────────────────────────────┤
+│  Predicted signals:                             │
+│  ├─ P(favorite)      LOW   - no emotional hook  │
+│  ├─ P(reply)         LOW   - no question/gap    │
+│  ├─ P(repost)        LOW   - no value to share  │
+│  ├─ P(quote)         LOW   - nothing to add to  │
+│  ├─ P(dwell)         LOW   - too short          │
+│  └─ P(not_interested) MED  - generic update     │
+│                                                 │
+│  Overall: WEAK                                  │
+│                                                 │
+│  Issues:                                        │
+│  • No specificity (what feature? why care?)     │
+│  • No emotional trigger                         │
+│  • No reason to engage                          │
+└─────────────────────────────────────────────────┘
+
+Optimize? (yes/no)
+```
+
+### Optimizing a Tweet
+
+```
+/x-algorithm optimize "Just shipped a new feature"
+
+OPTIMIZED VERSIONS:
+
+v1 (curiosity gap):
+"The feature everyone asked for just shipped.
+
+Took 6 months. Here's why it was worth the wait:"
+
+v2 (social proof):
+"1,247 people requested this feature.
+
+Today we shipped it.
+
+[screenshot]"
+
+v3 (contrarian):
+"Everyone said this feature was impossible.
+
+We built it anyway.
+
+Here's how:"
+
+---
+
+Which version, or iterate?
+```
+
+## Optimization Principles
+
+### Maximize Positive Signals
+
+**For P(favorite) - likes:**
+- Strong opinion or take
+- Relatable observation
+- Emotional resonance
+- Beautiful visually
+
+**For P(reply) - replies:**
+- Ask a question
+- Create a knowledge gap
+- Be slightly wrong (people love to correct)
+- Request input
+
+**For P(repost) - reposts:**
+- Provide shareable value (tips, insights)
+- Create "I wish I said that" moments
+- Make people look smart for sharing
+
+**For P(quote) - quotes:**
+- Leave room for commentary
+- Take a stance others want to respond to
+- Share something people want to add context to
+
+**For P(dwell) - time on tweet:**
+- Longer, readable content
+- Images that require study
+- Threads with substance
+- Videos
+
+**For P(follow) - new followers:**
+- Demonstrate unique expertise
+- Show personality
+- Consistent topic/niche
+
+### Minimize Negative Signals
+
+**Avoid P(not_interested):**
+- Don't be generic
+- Don't repeat what everyone says
+- Don't post off-topic
+
+**Avoid P(block/mute):**
+- Don't be annoying
+- Don't spam
+- Don't be hostile
+- Don't engage in bad faith
+
+**Avoid P(report):**
+- Don't violate ToS
+- Don't harass
+- Don't spread misinfo
+
+## High-Engagement Patterns
+
+### The Hook Patterns
+
+```
+1. CURIOSITY GAP
+   "I spent 3 years learning [X]. Here's what I wish I knew:"
+
+2. CONTRARIAN
+   "Unpopular opinion: [hot take]"
+
+3. STORY OPENER
+   "In 2019 I was [relatable struggle]. Now I [impressive outcome]."
+
+4. SPECIFIC NUMBER
+   "I've [done X] 847 times. Here's what works:"
+
+5. BEFORE/AFTER
+   "I used to [common mistake]. Then I learned [insight]."
+
+6. QUESTION
+   "What's one thing you wish you learned earlier about [X]?"
+```
+
+### Thread Structures That Work
+
+```
+LISTICLE:
+"10 [things] about [topic]:"
+→ High dwell, easy to repost individual tweets
+
+BUILD-UP:
+1. Hook
+2. Context
+3. Insight
+4. Proof
+5. Implication
+6. CTA
+→ Maximizes dwell across thread
+
+STORY:
+1. "It was 2AM when..."
+2. Rising action
+3. Crisis point
+4. Resolution
+5. Lesson
+6. CTA
+→ High engagement, emotional resonance
+```
+
+### Visual Content
+
+```
+IMAGES:
+- Screenshots > stock photos
+- Before/after comparisons
+- Data visualizations
+- Behind-the-scenes
+
+VIDEOS:
+- Hook in first 1-3 seconds
+- Subtitles (most watch muted)
+- Native upload > links
+- <2 min optimal
+```
+
+## Integration with /content
+
+When using `/content thread` or `/content post`, the X algorithm principles are automatically applied:
+
+```
+/content thread "our new pricing model"
+
+Applying X algorithm optimization...
+├─ Hook pattern: SPECIFIC NUMBER
+├─ Thread structure: BUILD-UP
+├─ Engagement triggers: curiosity, social proof
+└─ Visual: screenshot recommendation
+
+[generates thread with algorithm principles]
+```
+
+## Author Diversity Consideration
+
+The algorithm attenuates repeated authors. Posting strategy matters:
+
+```
+SUBOPTIMAL:
+Post → Post → Post → Post (same hour)
+Algorithm reduces later posts' reach
+
+BETTER:
+Post → [gap] → Post → [gap] → Post
+Each post gets full scoring potential
+```
+
+## Out-of-Network Discovery
+
+To reach beyond your followers:
+
+```
+- Quote tweet popular accounts (your take on their content)
+- Reply meaningfully to trending topics
+- Create highly repostable content (others share to their network)
+- Post content that generates quotes (your reach + quoter's reach)
+```
+
+## Metrics to Watch
+
+After posting, monitor:
+
+| Metric | What It Tells You |
+|--------|-------------------|
+| Impressions from For You | Algorithm reach |
+| Impressions from profile | Direct followers |
+| Engagement rate | Content quality signal |
+| Quote:Repost ratio | How "discussable" content is |
+| Reply quality | Community engagement depth |
+
+## Source
+
+Based on the open-sourced X algorithm:
+https://github.com/xai-org/x-algorithm
+
+The algorithm is continuously updated. Check the repo for latest changes.

package/template/templates/QUICKSTART_SKILL_TO_PRODUCT.md

@@ -0,0 +1,242 @@
+# Quick Start: Skill → Product Launch
+
+> You built a Claude Code skill. Now you want to monetize it.
+> This guide gets you from skill to paid product launch.
+
+---
+
+## The Pattern
+
+```
+SKILL (free)                    PRODUCT (paid)
+────────────                    ──────────────
+github.com/you/skill     →      yourproduct.io
+
+Open source                     Web app / better UX
+Builds awareness                Paywall ($5-$50)
+Shows it works                  Monetizes
+```
+
+---
+
+## Step 1: Foundation (30 min)
+
+### Fill out your vision
+
+Copy `templates/strategic/VISION.md` to `knowledge/VISION.md`:
+
+```markdown
+## The One-Liner
+{What does your skill do in one sentence?}
+
+## The Problem
+{What pain does this solve?}
+{Who has this problem?}
+
+## The Solution
+{How does your skill fix it?}
+
+## Why Paid?
+{What does the paid version add?}
+- Better UX?
+- More features?
+- Convenience?
+- Support?
+```
+
+### Fill out your narrative
+
+Copy `templates/strategic/NARRATIVE.md` to `knowledge/NARRATIVE.md`:
+
+```markdown
+## Tagline
+{5 words max}
+
+## Tweet
+{280 chars - the hook}
+
+## Elevator Pitch
+{30 seconds - problem, solution, why now}
+```
+
+---
+
+## Step 2: Brand (1 hour)
+
+### Fill out brand brief
+
+Copy `templates/brand/BRAND_BRIEF.md` to `knowledge/BRAND_BRIEF.md`:
+
+```markdown
+## Identity
+Name: {your product name}
+Tagline: {from narrative}
+Domain: {yourproduct.io}
+
+## Personality
+- Voice: {casual? professional? playful?}
+- Aesthetic: {minimal? bold? terminal?}
+
+## Mark Preferences
+- Type: {symbol? wordmark? lettermark?}
+- Constraints: {must work at 16px? specific colors?}
+```
+
+### Generate brand assets
+
+```bash
+claude
+/brand-architect
+```
+
+This creates:
+- Mark options in `outputs/svg/mark/`
+- Preview in `previews/brand/twitter-profile.html`
+
+### Make decisions
+
+Pick your mark, colors, typography. Record in `knowledge/BRAND_DECISIONS.md`.
+
+### Generate final assets
+
+```bash
+/web-architect implement all
+```
+
+This creates:
+- Favicons (all sizes)
+- OG image (for link previews)
+- Twitter banner
+- CSS tokens
+
+---
+
+## Step 3: Content (1-2 hours)
+
+### Launch thread
+
+```bash
+/content thread "launching {product name}"
+```
+
+Preview in `previews/content/twitter-thread.html`.
+
+### One-pager
+
+```bash
+/content one-pager "{product name}"
+```
+
+Preview in `previews/print/one-pager.html` - can export to PDF.
+
+### Landing page copy
+
+```bash
+/content landing-page "{product name}"
+```
+
+Gets you:
+- Hero headline
+- Problem/solution sections
+- Feature list
+- CTA copy
+
+---
+
+## Step 4: Launch Checklist
+
+### Pre-launch
+- [ ] Skill repo is public and README is good
+- [ ] Product is live (even if basic)
+- [ ] OG image set (link previews work)
+- [ ] Twitter profile updated (PFP, banner)
+- [ ] Launch thread drafted and reviewed
+
+### Launch day
+- [ ] Post launch thread
+- [ ] Pin tweet
+- [ ] Share in relevant communities
+- [ ] Reply to comments
+- [ ] Track metrics
+
+### Post-launch
+- [ ] Follow up thread (results, learnings)
+- [ ] Iterate based on feedback
+- [ ] Consider Product Hunt, Hacker News
+
+---
+
+## Example: JustCancel
+
+**Skill:** [just-fucking-cancel](https://github.com/rohunvora/just-fucking-cancel)
+- Claude Code skill
+- Upload CSVs, find subscriptions
+- Free, open source
+
+**Product:** [justcancel.io](https://justcancel.io)
+- Web app (same functionality)
+- $5 for full list with cancel links
+- Better UX, no CLI needed
+
+**Launch:**
+- Pinned tweet with demo video
+- Clear value prop: "Find subscriptions in 90 seconds"
+- Simple paywall: free preview, $5 for full access
+
+---
+
+## Timeline
+
+| Day | Activity |
+|-----|----------|
+| 0 | Fill out foundation docs |
+| 1 | Generate brand, make decisions |
+| 2 | Generate content, review |
+| 3 | Final prep, test everything |
+| 4 | **Launch** |
+| 5+ | Iterate, engage, follow up |
+
+---
+
+## Commands Reference
+
+```bash
+# Brand
+/brand-architect              # Full workflow
+/web-architect implement all  # Generate assets
+
+# Content
+/content thread [topic]       # Launch thread
+/content one-pager [topic]    # PDF summary
+/content post [topic]         # Single post
+
+# Status
+/hud                          # Campaign dashboard
+```
+
+---
+
+## Pricing
+
+| Product Type | Price Range | Notes |
+|--------------|-------------|-------|
+| Micro-tool | $5-$20 | One-time, impulse buy |
+| **Utility product** | **$50-$100** | **Solves real problem** |
+| Pro tool | $100-$200 | Power users, businesses |
+| SaaS | $20-$200/mo | Recurring, ongoing value |
+
+**Don't underprice.** If you built something useful, charge for it. $50-$200 is reasonable for a product that saves time or makes money.
+
+---
+
+## Tips
+
+1. **Keep it simple** - Your first launch doesn't need to be perfect
+2. **Show, don't tell** - Demo video > feature list
+3. **Price it right** - $50-$200 for real products, not $5
+4. **Launch fast** - Momentum matters more than polish
+5. **Engage** - Reply to every comment on launch day
+
+---
+
+Go ship it.

package/template/templates/brand/BRAND_BRIEF.md

@@ -0,0 +1,124 @@
+# Brand Brief
+
+> Fill this out and save to `knowledge/BRAND_BRIEF.md`
+
+---
+
+## Identity
+
+**Name:**
+<!-- Your brand name -->
+
+**Tagline:**
+<!-- One line that captures what you do / your essence -->
+
+**Domain:**
+<!-- yourbrand.com -->
+
+---
+
+## What You Do
+
+**One sentence:**
+<!-- Explain what you do in one sentence -->
+
+**For whom:**
+<!-- Who is your primary audience? -->
+
+**The problem you solve:**
+<!-- What pain point do you address? -->
+
+---
+
+## Personality
+
+**Values (pick 3-5):**
+<!-- What does your brand stand for? -->
+-
+-
+-
+
+**Voice:**
+<!-- How do you speak? Pick adjectives -->
+<!-- Examples: casual, professional, playful, serious, technical, accessible -->
+
+
+**Tone:**
+<!-- What's the emotional register? -->
+<!-- Examples: warm, cool, energetic, calm, provocative, reassuring -->
+
+
+---
+
+## Visual Direction
+
+**Aesthetic:**
+<!-- What visual style fits your brand? -->
+<!-- Examples: terminal/hacker, minimal, bold, playful, corporate, editorial -->
+
+
+**Inspiration:**
+<!-- Brands you admire visually (doesn't have to be same industry) -->
+-
+-
+-
+
+**Avoid:**
+<!-- Visual directions that feel wrong for your brand -->
+-
+
+---
+
+## Technical Constraints
+
+**Primary context:**
+<!-- Where will your brand appear most? -->
+<!-- Examples: web app, mobile app, CLI, social media, print -->
+
+
+**Theme preference:**
+<!-- Dark-first, light-first, or equal? -->
+
+
+**Existing colors:**
+<!-- Any colors you must use or want to incorporate? -->
+
+
+---
+
+## Mark Preferences
+
+**Type preference:**
+<!-- What kind of mark appeals to you? -->
+<!-- Options: symbol, lettermark, wordmark, icon, abstract, combination -->
+
+
+**Complexity:**
+<!-- Minimal (works at 16px) vs detailed (needs larger sizes) -->
+
+
+**Keywords for the mark:**
+<!-- Words that should inform the mark design -->
+-
+-
+-
+
+---
+
+## Examples of What You Like
+
+<!-- Paste URLs or describe marks/brands you like visually -->
+
+1.
+
+2.
+
+3.
+
+---
+
+## Anything Else
+
+<!-- Any other context that would help -->
+
+