# tweetnugget

Adopt this skill: https://proskills.md/skills/other/acailic-tweetnugget

Page: https://proskills.md/skills/other/acailic-tweetnugget
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 2595
upstream: https://github.com/acailic/tweetnugget/blob/HEAD/SKILL.md

````text
---
name: tweetnugget
description: Get a random inspirational quote from curated collections of hand-picked wisdom by tech leaders, founders, and philosophers. Supports filtering by topic or random surprise mode. 67 quotes across 3 collections.
version: 1.2.0
author: amplifier
tools:
  - bash  # Used only for: python3 script execution to read local JSON files
---

# TweetNugget

When the user asks for a quote, inspiration, or says something like "hit me with a quote" or "give me some wisdom":

## How It Works

1. Run `scripts/get_quote.py` to pick a quote from `references/` directory
2. Return the output directly to the user

## Quote Collections

The `references/` folder contains JSON files with this structure:

```json
{
  "name": "Collection Name",
  "description": "...",
  "quotes": [
    {
      "text": "The quote text",
      "author": "@handle",
      "url": "https://x.com/...",
      "tags": ["tag1", "tag2"]
    }
  ]
}
```

Available collections:
- `swlw-tweets.json` - 49 quotes from Software Lead Weekly newsletter (Dec-Jul 2025)
- `twitter-quotes.json` - 12 curated Twitter quotes
- `stoic-quotes.json` - 6 Stoic philosophy quotes

## Step-by-Step Instructions

### Basic: Get a random quote

```bash
python3 scripts/get_quote.py
```

Return the output directly to the user. Do not add commentary.

### Surprise Me: Random collection, then random quote

For variety across collections:

```bash
python3 scripts/get_quote.py --surprise
```

### Filtered: Get a quote by tag

If the user specifies a topic (e.g., "quote about AI", "something about leadership", "coding quote"):

```bash
python3 scripts/get_quote.py --tag ai
```

Replace `ai` with the user's topic. Uses partial matching (e.g., "lead" matches "leadership"). Falls back to a random quote if no match is found.

### Available Tags

Common tags across collections: `action`, `advice`, `ai`, `building`, `career`, `coding`, `courage`, `design`, `discipline`, `engineering`, `focus`, `happiness`, `humor`, `innovation`, `knowledge`, `leadership`, `learning`, `life`, `marketing`, `mindset`, `motivation`, `persistence`, `philosophy`, `product`, `programming`, `resilience`, `simplicity`, `startups`, `stoicism`, `strategy`, `thinking`, `wisdom`, `work`

## Response Format

Always return quotes in this format:

> "The quote text" — @handle

If the quote has a URL, you may optionally append it as a link. Keep responses minimal - let the quote speak for itself.

## Adding More Quotes

Users can add their own collections by placing new JSON files in the `references/` directory following the same format.
````

## File: README.md
upstream: https://github.com/acailic/tweetnugget/blob/HEAD/README.md

````text
# TweetNugget

*Nuggets of wisdom from the bird app*

Curated collections of inspirational tweets and wisdom from Twitter/X, designed to brighten your day with thoughtful insights from voices across the tech and philosophy worlds.

[![ClawHub](https://img.shields.io/badge/ClawHub-tweetnugget-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiI+PHRleHQgeD0iMCIgeT0iMTQiIGZvbnQtc2l6ZT0iMTQiPjwxPC90ZXh0Pjwvc3ZnPg==)](https://clawhub.dev/tweetnugget)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
![Version](https://img.shields.io/badge/version-1.2.0-brightgreen.svg)
[![Quote Count](https://img.shields.io/badge/quotes-67-yellow.svg)](https://github.com/acailic/tweetnugget)

## Install

### ClawHub (recommended)

```bash
clawhub install tweetnugget
```

Browse on [clawhub.dev/tweetnugget](https://clawhub.dev/tweetnugget)

### OpenClaw CLI

```bash
openclaw skills install tweetnugget
```

### Manual

Copy this folder to `~/.openclaw/skills/tweetnugget/`

## Quick Start

Once installed, request quotes in any chat where OpenClaw is active:
```
Give me a quote
Hit me with some wisdom
I need inspiration
Quote about AI
Something about leadership
Surprise me
```

## Why TweetNugget?

In a world of endless information, finding truly valuable insights can be challenging. TweetNugget solves this by:

- **Curated Wisdom**: Every quote is hand-picked from high-quality sources
- **Diverse Perspectives**: Insights from engineers, philosophers, entrepreneurs, and thought leaders
- **Easily Accessible**: Wisdom delivered exactly when you need it
- **Topic Filtering**: Find inspiration on specific topics that matter to you
- **Minimalist Design**: Focus on the content, not the interface

## Example Output

> "The purpose of knowledge is action." — @RyanHoliday

> "Most of coding was never about writing code. AI is just making this more obvious. You no longer need to recall syntax, function structure, boilerplate code, or even API endpoints. The hard part was never typing. It was always thinking. And it still is." — @Prathkum

> "Waste no more time arguing about what a good man should be. Be one." — @dailystoic - Marcus Aurelius

## How It Works

TweetNugget is an OpenClaw skill that delivers random inspirational tweets from curated JSON collections. When you request a quote, the skill:

1. **Filters by topic** (if specified) - matches your query against tagged quotes
2. **Selects randomly** - ensures variety and serendipity
3. **Presents beautifully** - displays the quote with attribution and source link
4. **Maintains quality** - all quotes are hand-curated for relevance and inspiration

## Collections

| Collection | Quotes | Source |
|---|---|---|
| `swlw-tweets.json` | 49 | Software Lead Weekly newsletter (issues #681-#657) |
| `twitter-quotes.json` | 12 | Curated Twitter wisdom |
| `stoic-quotes.json` | 6 | Stoic philosophy quotes |

**Total: 67 quotes across 3 collections**

## Available Tags

Filter quotes by topic: `action`, `advice`, `ai`, `anxiety`, `authorship`, `building`, `burnout`, `business`, `career`, `change`, `coding`, `confidence`, `creation`, `courage`, `decision-making`, `deliberate-practice`, `design`, `discipline`, `distribution`, `dopamine`, `early-career`, `engineering`, `excellence`, `explanation`, `finance`, `focus`, `goals`, `happiness`, `hiring`, `humor`, `identity`, `innovation`, `knowledge`, `leadership`, `learning`, `life`, `life-decisions`, `luck`, `marketing`, `meaningful-work`, `mindset`, `motivation`, `moving-on`, `passion`, `persistence`, `philosophy`, `planning`, `preparation`, `privacy`, `product`, `productivity`, `progress`, `programming`, `psychology`, `recruiting`, `relationships`, `resilience`, `satisfaction`, `simplicity`, `startups`, `stoicism`, `strategy`, `tech`, `thinking`, `time`, `time-money`, `tools`, `ux`, `vc`, `wisdom`, `work`

## Contributing

Add your own quote collections by placing new JSON files in the `references/` directory:

```json
{
  "name": "My Collection",
  "description": "A brief description",
  "quotes": [
    {
      "text": "The quote text",
      "author": "@handle",
      "url": "https://x.com/...",
      "tags": ["topic1", "topic2"]
    }
  ]
}
```

Fields:
- `text` (required): The quote text
- `author` (required): Twitter handle or attribution
- `url` (optional): Link to original tweet
- `category` (optional): Category label (e.g., "Software Engineering", "Philosophy")
- `tags` (optional): List of topic tags for filtering

## License

MIT
````