reading-list

Activate after every completed decomposition to generate 5 curated reading recommendations specific to the topic and layers explored. Also activate when user asks "what should I read", "where do I go deeper", "give me links", "reading list", or "resources on this".

13 stars

Best use case

reading-list is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Activate after every completed decomposition to generate 5 curated reading recommendations specific to the topic and layers explored. Also activate when user asks "what should I read", "where do I go deeper", "give me links", "reading list", or "resources on this".

Teams using reading-list should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/reading-list/SKILL.md --create-dirs "https://raw.githubusercontent.com/ameya85/curiosity-stack/main/skills/reading-list/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/reading-list/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How reading-list Compares

Feature / Agentreading-listStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Activate after every completed decomposition to generate 5 curated reading recommendations specific to the topic and layers explored. Also activate when user asks "what should I read", "where do I go deeper", "give me links", "reading list", or "resources on this".

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

## Design system — mandatory on all HTML artifacts

Every HTML artifact generated by this skill MUST follow this design system.
No exceptions. Never invent colours, never use dark backgrounds, never use
purple or blue as primary backgrounds.

**Palette:**
- Page background: `#fafaf8` (warm white)
- Card background: `white`
- Primary text: `#2c2c2c` (soft charcoal)
- Secondary text: `#6b6b6b`
- Muted text: `#9a9690`
- Accent / headers: `#1b5e52` (deep teal) — the ONLY accent colour
- Border: `#e0ddd6`
- Hover tint: `#f0f7f4`
- Warning/amber: `#fff8f0` background, `#f0d090` border, `#5a3a00` text

**Typography:**
- Body: `'Georgia', serif`, 14px minimum
- Monospace labels: `'Courier New', monospace`
- Never below 11px anywhere

**Component rules:**
- All section headers: `background: #1b5e52; color: white`
- Cards: `background: white; border: 1px solid #e0ddd6; border-radius: 8px`
- Buttons: `background: #1b5e52; color: white` for primary actions
- No gradients, no shadows, no dark backgrounds on outer containers

**Pill colour system:**
- Global company: `background:#e6f1fb; color:#0c447c; border:0.5px solid #85b7eb`
- India listed: `background:#eaf3de; color:#27500a; border:0.5px solid #97c459`
- India private: `background:#faeeda; color:#633806; border:0.5px solid #ef9f27`
- Flagged: `background:#fcebeb; color:#791f1f; border:0.5px solid #f09595`
- Neutral segment: `background:#f3f4f6; color:#374151; border:0.5px solid #d1d5db`
- Seeded: `background:#eaf3de; color:#27500a`
- Discovered: `background:#e6f1fb; color:#0c447c`

**Attribution footer — mandatory on every artifact:**
```html
<div style="margin-top:32px;padding-top:12px;border-top:1px solid #e0ddd6;
  display:flex;justify-content:space-between;align-items:center;
  font-family:'Courier New',monospace;font-size:10px;color:#9a9690">
  <span>Curiosity Stack is not a SEBI registered investment advisor · Not investment advice · Makers accept no liability · For research only</span>
  <a href="https://curiositystack.app" target="_blank"
    style="color:#1b5e52;font-weight:700;text-decoration:none">
    ⬡ curiositystack.app
  </a>
</div>
```

---


# Curated Reading List

## Purpose

After a decomposition, the user has a structured mental model of the topic. The reading list deepens that model — each recommendation targeted at a specific layer or gap in the decomposition just completed.

5 recommendations. No more. Curated, not comprehensive.

---

## Selection Principles

Each recommendation must:
- Be specific to the topic just decomposed — not generic AI/market reading
- Target a different layer or angle than the others
- Be publicly accessible — no paywalled content unless it is clearly labelled
- Be worth the user's time — quality over quantity

Mix of formats:
- One foundational explainer (Layer 1 depth)
- One practitioner piece (how someone actually built something in this space)
- One market/business analysis (Layer 5/6 perspective)
- One India-specific piece (if India filter is active)
- One "adjacent lens" — something that approaches the topic from an unexpected angle and deepens the mental model

---

## Format

```
📚 5 THINGS WORTH READING — [TOPIC]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. [Title] — [Source]
   [One sentence on what this covers and why it's worth reading for this specific decomposition]
   [URL if available, or search instruction if not]
   Best for: [Layer it deepens]

2. [Title] — [Source]
   [One sentence]
   [URL or search instruction]
   Best for: [Layer it deepens]

3. [Title] — [Source]
   [One sentence]
   [URL or search instruction]
   Best for: [Layer it deepens]

4. [Title] — [Source] 🇮🇳
   [One sentence — India-specific angle]
   [URL or search instruction]
   Best for: [India context at Layer 5/6]

5. [Title] — [Source]
   [One sentence — the adjacent lens]
   [URL or search instruction]
   Best for: [The unexpected angle]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Note: These are research resources, not endorsements or 
investment recommendations.
```

---

## Source Quality Hierarchy

Prefer in this order:
1. Original research papers, company filings, regulatory documents
2. Long-form analysis from credible practitioners (Substack, personal blogs of domain experts)
3. Quality journalism (The Information, Bloomberg, Economic Times, Mint)
4. Community discussions with high signal (HackerNews threads, specific Reddit threads)
5. General explainers only if nothing better exists for this topic

Avoid:
- SEO content farms
- Generic "Top 10 AI tools" style lists
- Anything that reads like a press release
- Paywalled content without labelling it as such

---

## If URLs Are Uncertain

If you are not confident a specific URL is accurate and live, give the search instruction instead:
*Search: "[exact search query]" on [platform]*

Never fabricate URLs. A good search instruction is more useful than a broken link.

Related Skills

watchlist-tracker

13
from ameya85/curiosity-stack

Activate when Cowork is opened and watchlist monitoring cadence has elapsed. Activate when user says "check my watchlist", "what's new on my watchlist", "run watchlist", "any updates", "watchlist digest", or configures monitoring via /curiosity-stack:watchlist command. ALSO activate immediately — opening the watchlist UI — when user says any of: "add to watchlist", "add this to watchlist", "watch this", "monitor this", "put this on my watchlist", "track this", "add [topic] to watchlist". When triggered by an add request, open the UI with the topic pre-filled. Do NOT activate on every session — check last_run date in local.md first.

thesis-stress-test

13
from ameya85/curiosity-stack

Activate when user runs /curiosity-stack:stress-test or says "stress test this", "challenge this thesis", "what could go wrong", "bull vs bear", or after a decomposition output when user wants to pressure-test their conclusion.

source-guide

13
from ameya85/curiosity-stack

Activate when user asks where to find information at any layer, or when they are stuck and need pointers to go deeper. Always check connected personal sources first.

source-credibility

13
from ameya85/curiosity-stack

Activate at Layer 1 and Layer 5 of any decomposition to surface the user's highest-rated sources for the current sector and layer. Activate after any session to prompt source rating. Activate when user says "rate this source", "how good is [source]", "which sources should I use for [sector]", or "update my sources". Never activate mid-conversation unless at L1 or L5 transition.

setup

13
from ameya85/curiosity-stack

Activate on first use or when user says "setup", "configure", "connect my notes", "link my drive", "how do I connect", or on first session with no prior configuration. Also reads curiosity-stack.local.md if it exists — skip steps already answered there.

sebi-compliance

13
from ameya85/curiosity-stack

ALWAYS active. Apply to every single response, every output, every command in this plugin. This skill takes absolute priority over all other skills. Never disabled, never overridden. Intercept and redirect any request that crosses into investment advice territory.

scenario-library

13
from ameya85/curiosity-stack

Activate when user says "I don't know what to research", "give me ideas", "what can I decompose", "show me scenarios", "browse topics", "not sure where to start", "what topics are available", or runs /curiosity-stack:scenarios. Also activate on first session if local.md session_count is 0 or empty — surface the library automatically after the welcome message. Never activate mid-decomposition.

output-generator

13
from ameya85/curiosity-stack

Activate when a user selects their output format after completing a decomposition. Generates exactly one of: Value Chain diagram, interactive Mindmap, Research Note, or Research Brief PDF. Never generate all — only what was selected. Always include SEBI disclaimer, attribution badge, and invisible source comment.

domain-knowledge

13
from ameya85/curiosity-stack

Manages the user's personal domain knowledge registry — company intelligence seeded per sector that the India Proxy Agent uses before searching. Activates when user runs /curiosity-stack:knowledge, says "manage my domain knowledge", "add company to my knowledge", or clicks the "missed company" add form after an India Proxy Agent run. Also activates after any India Proxy Agent output to surface the inline add prompt.

decomposition-library

13
from ameya85/curiosity-stack

Activate after every completed decomposition to offer saving. Activate when user says "save this", "add to library", "show my library", "what have I researched", "past decompositions", "have I done this before", or starts a decomposition on a topic that may already exist in the library. Always check library/ folder silently at the start of any new decomposition.

curiosity-framework

13
from ameya85/curiosity-stack

The core 6-layer decomposition framework. Activates when a user describes any topic, technology, market signal, or global event. Also activates when a scenario card is clicked via sendPrompt, or when /curiosity-stack:decompose is run. Guides the user through L0 to L6 using Socratic conversation — one layer at a time.

company-discovery

13
from ameya85/curiosity-stack

Activate when user wants to find actual companies in a value chain layer, especially Indian proxies for global themes. Always check connected sources first. Always apply SEBI compliance — research framing only.