$npx -y skills add prismatic-io/prismatic-skills --skill prismatic-docsThis skill should be used when the user asks "How do I...", "What is...", "How does X work in Prismatic?", "What's the best practice for...", wants to understand Prismatic concepts, features, or architecture, or needs guidance on marketplace deployment, customer connections, embe
| 1 | # Prismatic Documentation |
| 2 | |
| 3 | Search and retrieve Prismatic product documentation and code examples to answer conceptual questions, explain features, and provide best-practice guidance. |
| 4 | |
| 5 | ## Resources |
| 6 | |
| 7 | - **Documentation**: `https://prismatic.io/docs/` — Official product documentation |
| 8 | - **Examples**: `https://github.com/prismatic-io/examples` — Working code implementations |
| 9 | |
| 10 | ## Core Technique: Discover via llms.txt, read via `.md` |
| 11 | |
| 12 | Prismatic publishes an authoritative, LLM-optimized index of every docs page: |
| 13 | |
| 14 | ``` |
| 15 | https://prismatic.io/docs/llms.txt |
| 16 | ``` |
| 17 | |
| 18 | It lists 200+ pages as `[Title](full .md URL): one-line description` and is the **single |
| 19 | source of truth for doc URLs**. Each entry carries the page's `.md` URL, which returns clean |
| 20 | markdown (no HTML/CSS/JS) ideal for LLM consumption. |
| 21 | |
| 22 | **Look every doc URL up in `llms.txt`; never hand-construct one.** Doc pages live under |
| 23 | nested paths — for example Config Pages is |
| 24 | `https://prismatic.io/docs/integrations/config-wizard/config-pages.md`. Fetch `llms.txt`, |
| 25 | search it for your topic, and fetch the exact `.md` URL it lists. |
| 26 | |
| 27 | **Warning**: fetch `llms.txt` (the small index), NOT `llms-full.txt` — it exceeds 10MB and |
| 28 | times out. |
| 29 | |
| 30 | **Fallback** (when `llms.txt` doesn't surface the topic): `WebSearch` scoped to |
| 31 | `site:prismatic.io/docs <topic>`, then fetch that page's `.md`. |
| 32 | |
| 33 | ## Workflows |
| 34 | |
| 35 | ### Answer Conceptual Questions |
| 36 | |
| 37 | 1. Identify the topic from the user's question |
| 38 | 2. Fetch `llms.txt` and search it for the topic to get the page's exact `.md` URL |
| 39 | 3. Fetch that `.md` URL with WebFetch (clean markdown, no HTML/CSS/JS) |
| 40 | 4. Extract relevant information and present clearly |
| 41 | 5. Cite the page's HTML URL (drop the `.md`) so users can open it in a browser |
| 42 | |
| 43 | ### Find Code Examples |
| 44 | |
| 45 | 1. Identify the pattern needed (component, trigger, connection type, etc.) |
| 46 | 2. Search `https://github.com/prismatic-io/examples` for relevant examples |
| 47 | 3. Fetch raw file content if detailed analysis needed |
| 48 | 4. Present code with explanation |
| 49 | 5. Cite the GitHub URL |
| 50 | |
| 51 | ### Answer "How do I..." Questions |
| 52 | |
| 53 | 1. Search docs for conceptual guidance first |
| 54 | 2. Find related examples if code patterns help |
| 55 | 3. Combine documentation and examples for complete answer |
| 56 | 4. Cite both sources when applicable |
| 57 | |
| 58 | ## When to Use This Skill |
| 59 | |
| 60 | **Use prismatic-docs for:** |
| 61 | |
| 62 | - "How do config pages work?" |
| 63 | - "What connection types are available?" |
| 64 | - "Best practices for webhook triggers" |
| 65 | - "How to embed the marketplace" |
| 66 | - "Setup customer-activated connections" |
| 67 | - Code pattern examples |
| 68 | |
| 69 | **Use prismatic-api (not this skill) for:** |
| 70 | |
| 71 | - "What integrations do I have?" |
| 72 | - "List my customers" |
| 73 | - "Deploy this instance" |
| 74 | - "Show execution logs" |
| 75 | |
| 76 | ## Finding the right page |
| 77 | |
| 78 | **Fetch `llms.txt` and search it for the topic** to get the page's `.md` URL. That one index |
| 79 | covers every doc section — config wizard, connections, custom connectors, code-native, |
| 80 | embed/marketplace, triggers, instances, CLI, API — so it is how you locate any page. |
| 81 | |
| 82 | See `references/documentation-search.md` for task→topic mappings and search tips. |
| 83 | |
| 84 | ## Citation Format |
| 85 | |
| 86 | Always cite sources so users can learn more: |
| 87 | |
| 88 | **For documentation:** |
| 89 | |
| 90 | ``` |
| 91 | For more details, see: https://prismatic.io/docs/connections/ |
| 92 | ``` |
| 93 | |
| 94 | **For examples:** |
| 95 | |
| 96 | ``` |
| 97 | See the example: https://github.com/prismatic-io/examples/tree/main/components/example-name |
| 98 | ``` |
| 99 | |
| 100 | ## Key References |
| 101 | |
| 102 | - `references/documentation-search.md` — Full documentation paths, common tasks mapping, workflows |
| 103 | - `references/example-code.md` — GitHub examples navigation, search patterns, common categories |