Wondel.ai Skills

https://github.com/wondelai/skills
Admin
A collection of 50 agent skills providing specialized domain knowledge and frameworks for Claude...
Tokens:605,940
Snippets:8,396
Trust Score:5.6
License:MIT
Update:4 months ago
Show doc for...
Tokens:
Raw
### Single Command Build Example

Source: https://github.com/wondelai/skills/blob/main/clean-code/references/code-smells.md

Shows examples of single commands for building a system, which is considered good practice for environment setup. This avoids complex, multi-step build processes.

```bash
# GOOD: One command
make build
# or
npm run build
# or
./gradlew build
```

--------------------------------

### Install Wondel.ai Skills via skills.sh

Source: https://github.com/wondelai/skills/blob/main/README.md

Use the skills.sh command-line tool to install all Wondel.ai skills or individual skills.

```bash
# Install all skills
npx skills add wondelai/skills
```

```bash
# Or install individual skills
npx skills add wondelai/skills/jobs-to-be-done
npx skills add wondelai/skills/cro-methodology
npx skills add wondelai/skills/refactoring-ui
npx skills add wondelai/skills/ios-hig-design
npx skills add wondelai/skills/scorecard-marketing
npx skills add wondelai/skills/storybrand-messaging
npx skills add wondelai/skills/hooked-ux
npx skills add wondelai/skills/improve-retention
npx skills add wondelai/skills/ux-heuristics
npx skills add wondelai/skills/web-typography
npx skills add wondelai/skills/top-design
npx skills add wondelai/skills/negotiation
npx skills add wondelai/skills/influence-psychology
npx skills add wondelai/skills/lean-startup
npx skills add wondelai/skills/design-sprint
npx skills add wondelai/skills/crossing-the-chasm
npx skills add wondelai/skills/blue-ocean-strategy
npx skills add wondelai/skills/traction-eos
npx skills add wondelai/skills/design-everyday-things
npx skills add wondelai/skills/predictable-revenue
npx skills add wondelai/skills/made-to-stick
npx skills add wondelai/skills/drive-motivation
npx skills add wondelai/skills/hundred-million-offers
npx skills add wondelai/skills/obviously-awesome
npx skills add wondelai/skills/contagious
npx skills add wondelai/skills/one-page-marketing
npx skills add wondelai/skills/mom-test
npx skills add wondelai/skills/inspired-product
npx skills add wondelai/skills/lean-ux
npx skills add wondelai/skills/continuous-discovery
npx skills add wondelai/skills/microinteractions
npx skills add wondelai/skills/clean-code
npx skills add wondelai/skills/refactoring-patterns
npx skills add wondelai/skills/software-design-philosophy
npx skills add wondelai/skills/pragmatic-programmer
npx skills add wondelai/skills/domain-driven-design
npx skills add wondelai/skills/ddia-systems
npx skills add wondelai/skills/system-design
npx skills add wondelai/skills/clean-architecture
npx skills add wondelai/skills/release-it
npx skills add wondelai/skills/high-perf-browser
npx skills add wondelai/skills/37signals-way
npx skills add wondelai/skills/steve-jobs-design-review
npx skills add wondelai/skills/good-strategy-bad-strategy
npx skills add wondelai/skills/monetizing-innovation
npx skills add wondelai/skills/cold-start-problem
npx skills add wondelai/skills/working-with-legacy-code
npx skills add wondelai/skills/team-topologies
npx skills add wondelai/skills/high-output-management
npx skills add wondelai/skills/lean-analytics
```

--------------------------------

### Pipeline Math Example

Source: https://github.com/wondelai/skills/blob/main/predictable-revenue/SKILL.md

An example calculation demonstrating how to apply the pipeline math formulas to estimate the number of emails required to reach a revenue goal.

```math
Example: $1M ARR ÷ $20K deals = 50 deals; ÷ 25% win rate = 200 opportunities; at 10% response rate and 10% response-to-qualified conversion = 20,000 emails ≈ 2-3 SDRs (each sends 300-500/month).
```

--------------------------------

### Microphone Permission Usage String Example

Source: https://github.com/wondelai/skills/blob/main/ios-hig-design/references/privacy-permissions.md

Provides a specific example of a good usage string for the microphone permission, explaining its purpose in a user-friendly way.

```text
"MyApp uses the microphone to record voice notes for your journal entries."
```

--------------------------------

### Multiple Main Configurations for Different Environments

Source: https://github.com/wondelai/skills/blob/main/clean-architecture/references/boundaries.md

Demonstrates how different 'Main' configurations can be created for production, testing, and local development. This allows swapping concrete implementations of dependencies like repositories and emailers.

```python
# main_production.py
def create_app():
    repo = PostgresOrderRepository(production_db_pool)
    emailer = SendGridEmailer(production_api_key)
    ...

# main_test.py
def create_app():
    repo = InMemoryOrderRepository()
    emailer = FakeEmailer()
    ...

# main_local.py
def create_app():
    repo = SqliteOrderRepository("local.db")
    emailer = ConsoleEmailer()  # Prints to stdout
    ...
```

--------------------------------

### TCP Slow Start Growth Example

Source: https://github.com/wondelai/skills/blob/main/high-perf-browser/references/network-fundamentals.md

Illustrates the exponential growth of data sent during TCP's slow start phase. This shows how initial data transfer is limited.

```plaintext
Round 1: Send 10 segments (~14KB)
Round 2: Send 20 segments (~28KB)
Round 3: Send 40 segments (~56KB)
Round 4: Send 80 segments (~112KB)
...
```

--------------------------------

### Precondition Guard Example

Source: https://github.com/wondelai/skills/blob/main/pragmatic-programmer/SKILL.md

Use this pattern at the start of a function to enforce preconditions. It ensures that the function only proceeds if the input meets the specified criteria.

```python
assert age >= 0, "Age cannot be negative"
```

--------------------------------

### SaaS Onboarding Recipe

Source: https://github.com/wondelai/skills/blob/main/improve-retention/references/product-applications.md

A step-by-step recipe for SaaS onboarding, focusing on maximizing Ability and delivering value quickly to beat the motivation clock.

```text
1. Reduce signup to one click (SSO) — maximize Ability
2. Deliver first value in < 60 seconds — beat the motivation clock
3. Create one Tiny Habit — anchor to existing workflow
4. Send event-based prompts for Day 2-7 — don't spam
5. By Day 14, user should have a habit or you've lost them
```

--------------------------------

### Flag Argument Smell

Source: https://github.com/wondelai/skills/blob/main/clean-code/references/code-smells.md

Highlights the smell of using flag arguments in functions, indicating that the function might be doing too many things. The example shows a function with a boolean flag for admin setup.

```python
# BAD: Flag argument
def create_account(user_data, is_admin):
    if is_admin:
        # 15 lines of admin setup
    else:
        # 15 lines of regular setup
```

--------------------------------

### Sales Process Example: "The Revenue Engine"

Source: https://github.com/wondelai/skills/blob/main/traction-eos/references/process.md

This example outlines the steps for a sales process, including lead qualification, discovery calls, demos, proposals, follow-ups, closing, and handoff to the onboarding team.

```markdown
| Step | Action | Key Details | Exit Criteria |
|------|--------|-------------|--------------|
| 1 | **Qualify Lead** | Apply BANT criteria (Budget, Authority, Need, Timeline). Score 1-4. | Score of 3+ moves forward |
| 2 | **Discovery Call** | 30-minute structured call using question guide. Uncover 3 core pain points. | Pain points documented, next step agreed |
| 3 | **Demo** | Customized to prospect's pain points. Show, don't tell. 45 minutes max. | Prospect confirms fit |
| 4 | **Proposal** | Send within 24 hours of demo. Include 3 options (good/better/best). | Proposal delivered and receipt confirmed |
| 5 | **Follow Up** | 3 touches in 7 days: email (day 1), call (day 3), email (day 7). | Decision received |
| 6 | **Close** | Signed agreement and payment terms confirmed. | Contract signed |
| 7 | **Handoff** | Introduce customer to onboarding team. Complete handoff doc. | Onboarding team confirms receipt |
```

--------------------------------

### Designing Cache Interface Around Abstractions

Source: https://github.com/wondelai/skills/blob/main/software-design-philosophy/references/information-hiding.md

This Python example contrasts a 'leaking' cache interface that exposes implementation details (LRU, TTL) with a 'hiding' interface that focuses on abstract operations (get, put).

```python
# Leaking (how):
class Cache:
    def get_from_lru(self, key): ...
    def put_with_ttl(self, key, value, ttl_seconds): ...
    def evict_lru_entries(self, count): ...
```

```python
# Hiding (what):
class Cache:
    def get(self, key): ...
    def put(self, key, value): ...
    # LRU policy, TTL, eviction are internal decisions
```

--------------------------------

### Welcome Email 1: Deliver and Welcome

Source: https://github.com/wondelai/skills/blob/main/storybrand-messaging/references/email-sequences.md

Deliver the promised resource and set expectations for future communication. Use this on Day 0 after signup.

```email
Hi [Name],

[Deliver the promised resource - link/attachment]

Quick tip: Start with [section X] if you want to see results fast.

Here's what to expect from me:
- [Frequency] emails with [type of value]
- No spam, ever
- Unsubscribe anytime

Looking forward to helping you [achieve desired outcome].

[Signature]

P.S. If you have questions about [topic], just hit reply. I read every email.
```

--------------------------------

### Use Builder/Factory for Shared Setup

Source: https://github.com/wondelai/skills/blob/main/clean-code/SKILL.md

Employ builder or factory patterns to create test data and manage shared setup logic. This promotes code reuse and makes test setup more readable and maintainable.

```java
aUser().withRole(ADMIN).build()
```

--------------------------------

### Key-Range Partitioning Example

Source: https://github.com/wondelai/skills/blob/main/ddia-systems/references/partitioning.md

Illustrates how data is divided into partitions based on continuous ranges of keys. This method is efficient for range queries and supports natural ordering.

```text
Partition 1: keys A-E
Partition 2: keys F-J
Partition 3: keys K-O
Partition 4: keys P-T
Partition 5: keys U-Z
```

--------------------------------

### Starter Steps for Target Behaviors

Source: https://github.com/wondelai/skills/blob/main/improve-retention/SKILL.md

Illustrates the concept of 'Starter Steps' in the Tiny Habits method. These are the smallest possible versions of a target behavior, designed to reduce the barrier to entry and build momentum.

```text
Target Behavior | Starter Step | Why It Works
Complete onboarding | Fill in one field | Momentum from completion
Use analytics daily | Open the dashboard | Seeing data creates curiosity
Collaborate with team | Send one comment | Social reciprocity kicks in
```

--------------------------------

### Outcome-Based Roadmap Example

Source: https://github.com/wondelai/skills/blob/main/inspired-product/references/product-vision.md

An example of an outcome-based roadmap focusing on problems to solve and desired results.

```markdown
Q1: Reduce time-to-insight for daily users (target: <2 min)
    Improve enterprise security compliance (target: SOC 2 certification)
Q2: Enable core workflows on mobile (target: 30% mobile MAU)
    Help team leads identify at-risk accounts (target: churn prediction accuracy >80%)
```

--------------------------------

### Hash Partitioning Example

Source: https://github.com/wondelai/skills/blob/main/ddia-systems/references/partitioning.md

Shows how data is assigned to partitions by applying a hash function to the partition key and using the modulo operator. This ensures uniform distribution of keys.

```text
hash(key) mod N = partition number

hash("user_123") = 0x7A3F... -> Partition 3
hash("user_456") = 0x1B2C... -> Partition 1
hash("user_789") = 0xE4D1... -> Partition 5
```

--------------------------------

### Bad OKR Example

Source: https://github.com/wondelai/skills/blob/main/inspired-product/references/product-vision.md

An example of a poorly defined OKR that prescribes solutions rather than outcomes.

```markdown
Objective: Improve onboarding
KR1: Ship redesigned onboarding flow by March 15
KR2: Add 3 onboarding tooltips
KR3: Create 2 tutorial videos
```

--------------------------------

### Any-Node Contact Routing Example

Source: https://github.com/wondelai/skills/blob/main/ddia-systems/references/partitioning.md

Explains the any-node contact approach where a client can contact any node, which then forwards the request if it doesn't own the partition.

```text
Client -> Node A -> "Not my partition" -> forwards to Node B
```

--------------------------------

### Good OKR Example

Source: https://github.com/wondelai/skills/blob/main/inspired-product/references/product-vision.md

An example of a well-defined Objective and Key Results (OKRs) focusing on user outcomes.

```markdown
Objective: New users discover value in their first session
KR1: First-session completion rate increases from 35% to 60%
KR2: Time-to-first-value decreases from 12 minutes to 4 minutes
KR3: Day-7 retention for users who complete first session exceeds 70%
```

--------------------------------

### Repository Structure Example

Source: https://github.com/wondelai/skills/blob/main/CLAUDE.md

Illustrates the directory layout for agent skills, including configuration, skill files, reference materials, utility scripts, and documentation.

```tree
skills/
├── .claude-plugin/
│   └── marketplace.json   # Marketplace configuration for plugin installation
├── {skill-name}/
│   ├── SKILL.md           # Main skill file with YAML frontmatter + markdown instructions
│   └── references/        # Supporting reference files (optional)
│       └── *.md
├── scripts/               # Utility scripts
├── CLAUDE.md              # This file
└── README.md              # Skill catalog with descriptions and installation instructions
```

--------------------------------

### Example Titles for Content

Source: https://github.com/wondelai/skills/blob/main/contagious/references/practical-value.md

Illustrative examples of titles following the specified formula, designed to attract and inform.

```text
7 Simple Changes That Cut Our Electricity Bill in Half
```

```text
The 5-Minute Morning Routine Backed by Neuroscience
```

```text
3 Free Tools That Replace $500/Month in Software
```

--------------------------------

### K-Factor Calculation Example

Source: https://github.com/wondelai/skills/blob/main/contagious/references/viral-content-patterns.md

An example demonstrating how to calculate the K-factor using specific values for invitations per user and conversion rate. This illustrates a scenario resulting in a K-factor of 2.0.

```mathematics
K = 10 x 0.20 = 2.0
```

--------------------------------

### Filled-In V/TO Example: CloudSync

Source: https://github.com/wondelai/skills/blob/main/traction-eos/references/vto.md

An example of a completed V/TO for a B2B SaaS company, illustrating how to populate each section.

```plaintext
PAGE 1: VISION
  Core Values: 1. Own It  2. Radically Transparent  3. Ship Fast  4. Customers First  5. Stay Curious
  Core Focus — Purpose: To eliminate data silos for growing companies  Niche: Real-time data sync for mid-market SaaS
  10-Year Target: $100M ARR with 3,000 customers
  Marketing Strategy — Target: B2B SaaS companies, 50-500 employees, $5M-$50M revenue, VP Eng / CTO buyer
    Three Uniques: 1. Zero-downtime migrations  2. Sub-second sync latency  3. White-glove onboarding
    Proven Process: "The Sync Path" (Discovery → Audit → Migration → Go-Live → QBR)
    Guarantee: Full refund if data sync is not live within 30 days

PAGE 2: TRACTION
  3-Year Picture — Date: Dec 31, 2028  Revenue: $15M  Profit: $2.25M (15%)  Headcount: 85
    What it looks like: Regional leader in 3 metros, NPS 65+, 600 active accounts, two product lines above $5M, Best Places to Work
  1-Year Plan — Date: Dec 31, 2026  Revenue: $6.5M  Profit: $650K (10%)
    Goals: 1. 200 active accounts  2. Launch enterprise tier  3. Hire VP Sales  4. Achieve SOC 2 Type II  5. 95% gross retention
  Quarterly Rocks: 1. Close 15 new accounts (CRO)  2. Ship enterprise SSO (VP Eng)  3. Hire 3 SDRs (VP Sales)
    4. Launch partner program (CEO)  5. Reduce onboarding time to 14 days (CS Lead)  6. Publish SOC 2 report (CTO)
  Issues List: 1. Churn in SMB segment  2. Competitor launched free tier  3. Need senior backend engineer
    4. Support ticket volume growing 20% MoM  5. Pricing model under pressure from enterprise prospects
```

--------------------------------

### Pipeline Velocity Worked Example

Source: https://github.com/wondelai/skills/blob/main/predictable-revenue/references/pipeline-math.md

An example demonstrating the calculation of daily pipeline velocity based on given metrics.

```plaintext
Velocity = (50 x $30,000 x 0.25) / 60 = $6,250 per day
```

--------------------------------

### Camera Permission Usage String Example

Source: https://github.com/wondelai/skills/blob/main/ios-hig-design/references/privacy-permissions.md

Provides a specific example of a good usage string for the camera permission, explaining its purpose in a user-friendly way.

```text
"MyApp uses the camera to scan barcodes for quick product lookup."
```

--------------------------------

### Value Object Example

Source: https://github.com/wondelai/skills/blob/main/domain-driven-design/SKILL.md

Demonstrates a Value Object defined by its attributes, emphasizing immutability. Example: Address object.

```text
Address(street, city, zip)` -- replace, never mutate
```

--------------------------------

### Client-Side Routing Example

Source: https://github.com/wondelai/skills/blob/main/ddia-systems/references/partitioning.md

Illustrates client-side routing where the client maintains the partition map and connects directly to the appropriate node.

```text
Client: hash("user_123") -> Partition 3 -> Node B
Client connects directly to Node B
```

--------------------------------

### Practical Value Scoring Guide

Source: https://github.com/wondelai/skills/blob/main/contagious/references/practical-value.md

A guide to scoring content based on practical value, indicating its potential for sharing.

```text
**Scoring:**
- **0-20:** Low practical value. Content informs but doesn't compel sharing.
- **21-40:** Moderate practical value. Occasional shares to close contacts.
- **41-50:** High practical value. Regular forwards and saves.
- **51-60:** Exceptional practical value. Widely shared as a "must-read" resource.
```

--------------------------------

### Product Demo Opening Before/After

Source: https://github.com/wondelai/skills/blob/main/made-to-stick/references/applications.md

Contrasts a standard, feature-focused product demo opening with a sticky, pain-point-driven opening that immediately engages the audience.

```text
Before:
> "Hi, thanks for joining. Today I am going to give you a tour of our platform. Let me start with the dashboard..."

After:
> "Before I show you anything, I want you to think about the last time you needed a report for a meeting and could not find the right numbers in time. That happened to the VP of Sales at Notion last quarter. It cost them a $2M deal. Let me show you why that will never happen to you."
```

--------------------------------

### Composition Root Example in Python

Source: https://github.com/wondelai/skills/blob/main/clean-architecture/references/adapters-frameworks.md

This Python code demonstrates the composition root, where concrete infrastructure, gateways, presenters, and controllers are instantiated and wired together. It shows how to swap implementations like databases or email services by changing only this 'main' component.

```python
# main.py -- the composition root
def create_app():
    # Concrete infrastructure
    db_pool = create_connection_pool(os.environ["DATABASE_URL"])
    email_client = SendGridClient(os.environ["SENDGRID_API_KEY"])

    # Gateways (implement interfaces)
    order_repo = PostgresOrderRepository(db_pool)
    email_service = SendGridEmailService(email_client)

    # Presenters
    order_presenter = JsonOrderPresenter()

    # Use Cases (wired with concrete dependencies)
    place_order = PlaceOrderInteractor(order_repo, order_presenter)
    cancel_order = CancelOrderInteractor(order_repo, email_service, order_presenter)

    # Controllers (wired with use cases)
    order_controller = OrderController(place_order, cancel_order)

    # Framework wiring
    app = Flask(__name__)
    app.route("/orders", methods=["POST"])(order_controller.create)
    app.route("/orders/<id>/cancel", methods=["POST"])(order_controller.cancel)

    return app
```

--------------------------------

### Internal Tools Hypothesis Example

Source: https://github.com/wondelai/skills/blob/main/lean-ux/references/hypothesis-canvas.md

An example hypothesis statement for internal tools, focused on improving support agent efficiency.

```plaintext
"We believe support ticket resolution time will decrease by 30% if support agents can view the full customer timeline without switching tabs with a unified customer context panel in the ticket view."
```

--------------------------------

### E-commerce Checkout Redesign Hypothesis Example

Source: https://github.com/wondelai/skills/blob/main/lean-ux/references/hypothesis-canvas.md

An example hypothesis statement for an e-commerce scenario, focusing on reducing cart abandonment.

```plaintext
"We believe cart abandonment will drop by 20% if returning shoppers can complete checkout in under 60 seconds with a one-click reorder button on the product page."
```

--------------------------------

### Specification Pattern Example

Source: https://github.com/wondelai/skills/blob/main/domain-driven-design/SKILL.md

Demonstrates the Specification pattern for encapsulating query criteria as domain objects. Example: OverdueBy specification.

```text
spec = OverdueBy(days=30); repo.findMatching(spec)
```

--------------------------------

### Repository Layer Structure Example

Source: https://github.com/wondelai/skills/blob/main/domain-driven-design/references/repositories-factories.md

Illustrates the typical directory structure for domain and infrastructure layers, showing where repository interfaces and implementations reside.

```python
domain/
    model/
        Order.py              # Aggregate root
        OrderLineItem.py      # Entity within aggregate
    repository/
        OrderRepository.py    # Interface (abstract class / protocol)

infrastructure/
    persistence/
        PostgresOrderRepository.py    # Implementation
        InMemoryOrderRepository.py    # Implementation for tests
```

--------------------------------

### Example Lean UX User Story with Hypothesis

Source: https://github.com/wondelai/skills/blob/main/lean-ux/references/agile-integration.md

A concrete example demonstrating the Lean UX hypothesis-driven user story format, including a specific scenario, hypothesis, success metric, and experiment validation.

```markdown
As a project manager, I want to filter tasks by due date, so that I can focus on urgent work.

HYPOTHESIS: We believe task completion rate will increase by 15% if project managers
use a due-date filter to surface overdue tasks.
SUCCESS METRIC: Task completion rate measured over 2 weeks post-launch.
EXPERIMENT: Validated with clickable prototype (5 users, 4/5 completed filter task
in under 10 seconds, all reported it would change their daily workflow).

Acceptance criteria:
- Filter dropdown with options: Today, This Week, Overdue, Custom Range
- Persists across sessions
- Works on mobile
```

--------------------------------

### Repository Interface Example

Source: https://github.com/wondelai/skills/blob/main/domain-driven-design/SKILL.md

Presents a Repository interface in the domain layer for data access abstraction. Example: OrderRepository.findByCustomer in domain.

```text
OrderRepository.findByCustomer(customerId)` in domain; `PostgresOrderRepository` in infrastructure
```

--------------------------------

### Deal Perception Lever: Unexpected Discount Example

Source: https://github.com/wondelai/skills/blob/main/contagious/references/practical-value.md

Provides an example of offering a surprise discount to enhance perceived value.

```text
"We noticed you were looking at this — here's 20% off"
```
Tokens:
Raw