luckiest-co 1.0.1 → 1.0.3

package/skills/luckiest-competitors/references/content-architecture.md

@@ -0,0 +1,271 @@
+# Content Architecture for Competitor Pages
+
+How to structure and maintain competitor data for scalable comparison pages.
+
+## Contents
+- Centralized Competitor Data
+- Competitor Data Template
+- Your Product Data
+- Page Generation
+- Index Page Structure (alternatives index, vs comparisons index, index page best practices)
+- Footer Navigation
+
+## Centralized Competitor Data
+
+Create a single source of truth for each competitor:
+
+```
+competitor_data/
+├── notion.md
+├── airtable.md
+├── monday.md
+└── ...
+```
+
+---
+
+## Competitor Data Template
+
+Per competitor, document:
+
+```yaml
+name: Notion
+website: notion.so
+tagline: "The all-in-one workspace"
+founded: 2016
+headquarters: San Francisco
+
+# Positioning
+primary_use_case: "docs + light databases"
+target_audience: "teams wanting flexible workspace"
+market_position: "premium, feature-rich"
+
+# Pricing
+pricing_model: per-seat
+free_tier: true
+free_tier_limits: "limited blocks, 1 user"
+starter_price: $8/user/month
+business_price: $15/user/month
+enterprise: custom
+
+# Features (rate 1-5 or describe)
+features:
+  documents: 5
+  databases: 4
+  project_management: 3
+  collaboration: 4
+  integrations: 3
+  mobile_app: 3
+  offline_mode: 2
+  api: 4
+
+# Strengths (be honest)
+strengths:
+  - Extremely flexible and customizable
+  - Beautiful, modern interface
+  - Strong template ecosystem
+  - Active community
+
+# Weaknesses (be fair)
+weaknesses:
+  - Can be slow with large databases
+  - Learning curve for advanced features
+  - Limited automations compared to dedicated tools
+  - Offline mode is limited
+
+# Best for
+best_for:
+  - Teams wanting all-in-one workspace
+  - Content-heavy workflows
+  - Documentation-first teams
+  - Startups and small teams
+
+# Not ideal for
+not_ideal_for:
+  - Complex project management needs
+  - Large databases (1000s of rows)
+  - Teams needing robust offline
+  - Enterprise with strict compliance
+
+# Common complaints (from reviews)
+common_complaints:
+  - "Gets slow with lots of content"
+  - "Hard to find things as workspace grows"
+  - "Mobile app is clunky"
+
+# Migration notes
+migration_from:
+  difficulty: medium
+  data_export: "Markdown, CSV, HTML"
+  what_transfers: "Pages, databases"
+  what_doesnt: "Automations, integrations setup"
+  time_estimate: "1-3 days for small team"
+```
+
+---
+
+## Your Product Data
+
+Same structure for yourself—be honest:
+
+```yaml
+name: [Your Product]
+# ... same fields
+
+strengths:
+  - [Your real strengths]
+
+weaknesses:
+  - [Your honest weaknesses]
+
+best_for:
+  - [Your ideal customers]
+
+not_ideal_for:
+  - [Who should use something else]
+```
+
+---
+
+## Page Generation
+
+Each page pulls from centralized data:
+
+- **[Competitor] Alternative page**: Pulls competitor data + your data
+- **[Competitor] Alternatives page**: Pulls competitor data + your data + other alternatives
+- **You vs [Competitor] page**: Pulls your data + competitor data
+- **[A] vs [B] page**: Pulls both competitor data + your data
+
+**Benefits**:
+- Update competitor pricing once, updates everywhere
+- Add new feature comparison once, appears on all pages
+- Consistent accuracy across pages
+- Easier to maintain at scale
+
+---
+
+## Index Page Structure
+
+### Alternatives Index
+
+**URL**: `/alternatives` or `/alternatives/index`
+
+**Purpose**: Lists all "[Competitor] Alternative" pages
+
+**Page structure**:
+1. Headline: "[Your Product] as an Alternative"
+2. Brief intro on why people switch to you
+3. List of all alternative pages with:
+   - Competitor name/logo
+   - One-line summary of key differentiator vs. that competitor
+   - Link to full comparison
+4. Common reasons people switch (aggregated)
+5. CTA
+
+**Example**:
+```markdown
+## Explore [Your Product] as an Alternative
+
+Looking to switch? See how [Your Product] compares to the tools you're evaluating:
+
+- **[Notion Alternative](/alternatives/notion)** — Better for teams who need [X]
+- **[Airtable Alternative](/alternatives/airtable)** — Better for teams who need [Y]
+- **[Monday Alternative](/alternatives/monday)** — Better for teams who need [Z]
+```
+
+---
+
+### Vs Comparisons Index
+
+**URL**: `/vs` or `/compare`
+
+**Purpose**: Lists all "You vs [Competitor]" and "[A] vs [B]" pages
+
+**Page structure**:
+1. Headline: "Compare [Your Product]"
+2. Section: "[Your Product] vs Competitors" — list of direct comparisons
+3. Section: "Head-to-Head Comparisons" — list of [A] vs [B] pages
+4. Brief methodology note
+5. CTA
+
+---
+
+### Index Page Best Practices
+
+**Keep them updated**: When you add a new comparison page, add it to the relevant index.
+
+**Internal linking**:
+- Link from index → individual pages
+- Link from individual pages → back to index
+- Cross-link between related comparisons
+
+**SEO value**:
+- Index pages can rank for broad terms like "project management tool comparisons"
+- Pass link equity to individual comparison pages
+- Help search engines discover all comparison content
+
+**Sorting options**:
+- By popularity (search volume)
+- Alphabetically
+- By category/use case
+- By date added (show freshness)
+
+**Include on index pages**:
+- Last updated date for credibility
+- Number of pages/comparisons available
+- Quick filters if you have many comparisons
+
+---
+
+## Footer Navigation
+
+The site footer appears on all marketing pages, making it a powerful internal linking opportunity for competitor pages.
+
+### Option 1: Link to Index Pages (Minimum)
+
+At minimum, add links to your comparison index pages in the footer:
+
+```
+Footer
+├── Compare
+│   ├── Alternatives →  /alternatives
+│   └── Comparisons →  /vs
+```
+
+This ensures every marketing page passes link equity to your comparison content hub.
+
+### Option 2: Footer Columns by Format (Recommended for SEO)
+
+For stronger internal linking, create dedicated footer columns for each format you've built, linking directly to your top competitors:
+
+```
+Footer
+├── [Product] vs               ├── Alternatives to            ├── Compare
+│   ├── vs Notion              │   ├── Notion Alternative     │   ├── Notion vs Airtable
+│   ├── vs Airtable            │   ├── Airtable Alternative   │   ├── Monday vs Asana
+│   ├── vs Monday              │   ├── Monday Alternative     │   ├── Notion vs Monday
+│   ├── vs Asana               │   ├── Asana Alternative      │   ├── ...
+│   ├── vs Clickup             │   ├── Clickup Alternative    │   └── View all →
+│   ├── ...                    │   ├── ...                    │
+│   └── View all →             │   └── View all →             │
+```
+
+**Guidelines**:
+- Include up to 8 links per column (top competitors by search volume)
+- Add "View all" link to the full index page
+- Only create columns for formats you've actually built pages for
+- Prioritize competitors with highest search volume
+
+### Why Footer Links Matter
+
+1. **Sitewide distribution**: Footer links appear on every marketing page, passing link equity from your entire site to comparison content
+2. **Crawl efficiency**: Search engines discover all comparison pages quickly
+3. **User discovery**: Visitors evaluating your product can easily find comparisons
+4. **Competitive positioning**: Signals to search engines that you're a key player in the space
+
+### Implementation Notes
+
+- Update footer when adding new high-priority comparison pages
+- Keep footer clean—don't list every comparison, just the top ones
+- Match column headers to your URL structure (e.g., "vs" column → `/vs/` URLs)
+- Consider mobile: columns may stack, so order by priority

package/skills/luckiest-competitors/references/templates.md

@@ -0,0 +1,223 @@
+# Section Templates for Competitor Pages
+
+Ready-to-use templates for each section of competitor comparison pages.
+
+## Contents
+- TL;DR Summary
+- Paragraph Comparison (Not Just Tables)
+- Feature Comparison Section
+- Pricing Comparison Section
+- Service & Support Comparison
+- Who It's For Section
+- Migration Section
+- Social Proof Section
+- Comparison Table Best Practices (beyond checkmarks, organize by category, include ratings where useful)
+
+## TL;DR Summary
+
+Start every page with a quick summary for scanners:
+
+```markdown
+**TL;DR**: [Competitor] excels at [strength] but struggles with [weakness].
+[Your product] is built for [your focus], offering [key differentiator].
+Choose [Competitor] if [their ideal use case]. Choose [You] if [your ideal use case].
+```
+
+---
+
+## Paragraph Comparison (Not Just Tables)
+
+For each major dimension, write a paragraph:
+
+```markdown
+## Features
+
+[Competitor] offers [description of their feature approach].
+Their strength is [specific strength], which works well for [use case].
+However, [limitation] can be challenging for [user type].
+
+[Your product] takes a different approach with [your approach].
+This means [benefit], though [honest tradeoff].
+Teams who [specific need] often find this more effective.
+```
+
+---
+
+## Feature Comparison Section
+
+Go beyond checkmarks:
+
+```markdown
+## Feature Comparison
+
+### [Feature Category]
+
+**[Competitor]**: [2-3 sentence description of how they handle this]
+- Strengths: [specific]
+- Limitations: [specific]
+
+**[Your product]**: [2-3 sentence description]
+- Strengths: [specific]
+- Limitations: [specific]
+
+**Bottom line**: Choose [Competitor] if [scenario]. Choose [You] if [scenario].
+```
+
+---
+
+## Pricing Comparison Section
+
+```markdown
+## Pricing
+
+| | [Competitor] | [Your Product] |
+|---|---|---|
+| Free tier | [Details] | [Details] |
+| Starting price | $X/user/mo | $X/user/mo |
+| Business tier | $X/user/mo | $X/user/mo |
+| Enterprise | Custom | Custom |
+
+**What's included**: [Competitor]'s $X plan includes [features], while
+[Your product]'s $X plan includes [features].
+
+**Total cost consideration**: Beyond per-seat pricing, consider [hidden costs,
+add-ons, implementation]. [Competitor] charges extra for [X], while
+[Your product] includes [Y] in base pricing.
+
+**Value comparison**: For a 10-person team, [Competitor] costs approximately
+$X/year while [Your product] costs $Y/year, with [key differences in what you get].
+```
+
+---
+
+## Service & Support Comparison
+
+```markdown
+## Service & Support
+
+| | [Competitor] | [Your Product] |
+|---|---|---|
+| Documentation | [Quality assessment] | [Quality assessment] |
+| Response time | [SLA if known] | [Your SLA] |
+| Support channels | [List] | [List] |
+| Onboarding | [What they offer] | [What you offer] |
+| CSM included | [At what tier] | [At what tier] |
+
+**Support quality**: Based on [G2/Capterra reviews, your research],
+[Competitor] support is described as [assessment]. Common feedback includes
+[quotes or themes].
+
+[Your product] offers [your support approach]. [Specific differentiator like
+response time, dedicated CSM, implementation help].
+```
+
+---
+
+## Who It's For Section
+
+```markdown
+## Who Should Choose [Competitor]
+
+[Competitor] is the right choice if:
+- [Specific use case or need]
+- [Team type or size]
+- [Workflow or requirement]
+- [Budget or priority]
+
+**Ideal [Competitor] customer**: [Persona description in 1-2 sentences]
+
+## Who Should Choose [Your Product]
+
+[Your product] is built for teams who:
+- [Specific use case or need]
+- [Team type or size]
+- [Workflow or requirement]
+- [Priority or value]
+
+**Ideal [Your product] customer**: [Persona description in 1-2 sentences]
+```
+
+---
+
+## Migration Section
+
+```markdown
+## Switching from [Competitor]
+
+### What transfers
+- [Data type]: [How easily, any caveats]
+- [Data type]: [How easily, any caveats]
+
+### What needs reconfiguration
+- [Thing]: [Why and effort level]
+- [Thing]: [Why and effort level]
+
+### Migration support
+
+We offer [migration support details]:
+- [Free data import tool / white-glove migration]
+- [Documentation / migration guide]
+- [Timeline expectation]
+- [Support during transition]
+
+### What customers say about switching
+
+> "[Quote from customer who switched]"
+> — [Name], [Role] at [Company]
+```
+
+---
+
+## Social Proof Section
+
+Focus on switchers:
+
+```markdown
+## What Customers Say
+
+### Switched from [Competitor]
+
+> "[Specific quote about why they switched and outcome]"
+> — [Name], [Role] at [Company]
+
+> "[Another quote]"
+> — [Name], [Role] at [Company]
+
+### Results after switching
+- [Company] saw [specific result]
+- [Company] reduced [metric] by [amount]
+```
+
+---
+
+## Comparison Table Best Practices
+
+### Beyond Checkmarks
+
+Instead of:
+| Feature | You | Competitor |
+|---------|-----|-----------|
+| Feature A | ✓ | ✓ |
+| Feature B | ✓ | ✗ |
+
+Do this:
+| Feature | You | Competitor |
+|---------|-----|-----------|
+| Feature A | Full support with [detail] | Basic support, [limitation] |
+| Feature B | [Specific capability] | Not available |
+
+### Organize by Category
+
+Group features into meaningful categories:
+- Core functionality
+- Collaboration
+- Integrations
+- Security & compliance
+- Support & service
+
+### Include Ratings Where Useful
+
+| Category | You | Competitor | Notes |
+|----------|-----|-----------|-------|
+| Ease of use | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | [Brief note] |
+| Feature depth | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | [Brief note] |

package/skills/luckiest-content-strategy/ATTRIBUTION.md

@@ -0,0 +1,39 @@
+# Attribution
+
+This skill is the Luckiest edition of the **"content-strategy"** skill from the
+marketingskills project (https://github.com/coreyhaines31/marketingskills) by
+Corey Haines (https://corey.co), used under the MIT License.
+
+The Luckiest edition rebrands the skill and its cross-references to
+`luckiest-content-strategy`, restructures the frontmatter to the Agent Skills
+spec, adds an existing-content audit workflow and answer-engine planning
+guidance, adds a share-with-tribe network hook and the Luckiest update-check,
+and preserves the original headless-CMS reference and evals. See `CHANGELOG.md`
+for the full record. The original copyright is retained below and is never
+stripped.
+
+## Original license
+
+```
+MIT License
+
+Copyright (c) 2025 Corey Haines
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/skills/luckiest-content-strategy/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog — luckiest-content-strategy
+
+## 1.1.0 — 2026-07-06
+Skill updater pass: analytics integration.
+
+### Analytics (report_usage)
+- Updated `report_usage` call to `skill_version: "1.1.0"` and `check_updates`
+  `installedSemver: "1.1.0"`. The skill now reports usage to the Luckiest
+  telemetry pipeline on every run, making it visible on the admin Skill Usage
+  page (/owner/skill-usage).
+
+## 1.0.0 — 2026-07-01
+Rebranded from content-strategy (marketingskills, MIT).
+
+### Improve pass (/refract)
+- Added an "Existing Content First: Audit Before Producing" section with a keep/refresh/consolidate/retire decision model. The original treated strategy as net-new production only, even though its own eval #2 ("200+ posts, flat traffic") requires an audit-and-refresh workflow. Content decay was previously unaddressed.
+- Expanded the single "optimize for AI/LLM discovery" line into concrete answer-engine planning guidance (question-shaped, self-contained, extractable sections) and cross-referenced luckiest-ai-seo instead of duplicating depth.
+
+### Network hook
+- Share-with-tribe: after the content strategy is delivered, the skill offers (never auto-posts) to surface the pillar map and priority topics to the user's Luckiest tribe so others planning in the same space can pick up where they left off. Private research, transcripts, and credentials are never shared.
+
+### Trend pass (/newsjack + /luckiest-trends)
+- No actionable signal. The newsjack CLI is not installed and no verifiable host web-search tool was available in this session, so no external signal could be confirmed. No fabricated signal was added.