book-catalog

$npx mdskill add foxminchan/BookWorm/book-catalog

Search and recommend books from BookWorm's catalog based on user preferences.

  • Helps users find books by title, author, genre, price, or rating.
  • Uses the `search_catalog` tool to query BookWorm's database.
  • Ranks results by ratings, popularity, and price for recommendations.
  • Presents options with title, author, genre, description, and price.

SKILL.md

.github/skills/book-catalogView on GitHub ↗
---
name: book-catalog
description: Search and recommend books from BookWorm's catalog. Use when customers ask about finding books, getting personalized recommendations, exploring genres, discovering authors, or comparing titles.
metadata:
  author: Nhan Nguyen
  version: "1.0"
license: MIT
---

# Book Catalog

## Search Capabilities

Use the `search_catalog` tool to find books. The catalog supports:

| Filter           | Examples                                  |
|------------------|-------------------------------------------|
| Title keyword    | "clean code", "dune"                      |
| Author name      | "Martin Fowler", "Frank Herbert"          |
| Genre / category | "science fiction", "software engineering" |
| Price range      | min/max price filters                     |
| Rating           | minimum star rating                       |
| Availability     | in-stock only                             |

## Recommendation Strategy

1. **Clarify preferences** — Ask about genre, favorite authors, reading level, or purpose (gift, self-learning,
   leisure).
2. **Search first** — Always use `search_catalog` before recommending; never invent titles.
3. **Rank results** — Prefer higher ratings, then popularity, then price.
4. **Provide context** — Include author, genre, a one-sentence description, and price.
5. **Suggest alternatives** — Offer 2–3 options when possible.

## Response Format

- Present books as a numbered or bulleted list.
- Include: **Title** — _Author_ — Genre — ⭐ Rating — 💲 Price.
- If no results, say so and offer to broaden the search.

## Handoff Rules

- Policy or account questions → hand off to QAAgent.
- Emotional feedback or complaints → hand off to SentimentAgent.
- Complete ongoing book task before any handoff.

For catalog browsing tips and genre descriptions, see [references/CATALOG_GUIDE.md](references/CATALOG_GUIDE.md).
For a sample book listing template, see [assets/book-listing-template.md](assets/book-listing-template.md).

More from foxminchan/BookWorm

SkillDescription
aspire>-
aspire-deployment**WORKFLOW SKILL** — Deploy Aspire apps from AppHost models to Docker Compose, Kubernetes, Azure, or AWS. WHEN: "deploy Aspire app", "publish Aspire artifacts", "deploy to Azure Container Apps", "generate Kubernetes artifacts", "tear down Aspire deployment". INVOKES: aspire CLI, Aspire docs, target cloud/container CLIs. FOR SINGLE OPERATIONS: use generic Azure, Kubernetes, Docker, or AWS tools only when no Aspire AppHost exists.
aspire-init>-
aspire-monitoring>-
aspire-orchestration>-
aspireify>-
catalog-documentation-creatorGenerates EventCatalog documentation files (services, agents, events, commands, queries, domains, flows, channels, containers) with correct frontmatter, folder structure, and best practices. Use when user asks to "document a service", "document an agent", "document an AI agent", "create EventCatalog files", "add an event to the catalog", "document my architecture", "generate catalog documentation", "create documentation for my microservice", or "document a database".
code-to-catalogTurns a codebase into EventCatalog documentation through an evidence-based interview. Scans the code first, proposes an architectural model (domains, services, agents, messages, channels), grills the user on the structural decisions, produces a reviewable plan file, then hands off to catalog-documentation-creator. Use when user says "document my codebase in EventCatalog", "turn this repo into a catalog", "model my code as a catalog", "document my agents", "document my AI agents", "grill me on my architecture", "update my catalog from the code", "reconcile my catalog with my code", or "I don't know where to start documenting this codebase". Works for brand-new catalogs AND for updating existing catalogs that have drifted from the code.
csharp-tunitGet best practices for TUnit unit testing, including data-driven tests
flow-wizardGuides users through documenting business flows step-by-step in EventCatalog, including services, agents, messages, actors, and external systems. Use when user asks to "document a flow", "map a business process", "create a flow diagram", "walk through a process", "document an end-to-end flow", "map an agent workflow", or "map out how something works in my architecture".