Prismatic-skills prismatic-docs

This 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, embedded UI, config pages, triggers, or other Prismatic product features. Search and retrieve documentation from prismatic.io/docs and reference examples from github.com/prismatic-io/examples.

install
source · Clone the upstream repo
git clone https://github.com/prismatic-io/prismatic-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/prismatic-io/prismatic-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/prismatic-docs" ~/.claude/skills/prismatic-io-prismatic-skills-prismatic-docs && rm -rf "$T"
manifest: skills/prismatic-docs/SKILL.md
source content

Prismatic Documentation

Search and retrieve Prismatic product documentation and code examples to answer conceptual questions, explain features, and provide best-practice guidance.

Resources

  • Documentation:
    https://prismatic.io/docs/
    — Official product documentation
  • Examples:
    https://github.com/prismatic-io/examples
    — Working code implementations

Core Technique: Markdown Fetch

Prismatic docs pages serve clean markdown by appending

.md
to the URL path:

HTML URLMarkdown URL
https://prismatic.io/docs/connections/
https://prismatic.io/docs/connections.md
https://prismatic.io/docs/config-pages/
https://prismatic.io/docs/config-pages.md

The

.md
version strips HTML/CSS/JS, returning clean content ideal for LLM consumption.

Discovery Methods

Method 1: Index Lookup (llms.txt)

Fetch the page index to find the right documentation page:

https://prismatic.io/docs/llms.txt

This contains 200+ page titles with URLs. Search for keywords to find relevant pages.

Warning: Do NOT use

llms-full.txt
— it exceeds 10MB and will timeout.

Method 2: Web Search

Use WebSearch scoped to

prismatic.io
when the topic is unclear:

site:prismatic.io/docs <topic>

Method 3: Direct Fetch

For known topics, fetch directly using common paths (see reference file).

Workflows

Answer Conceptual Questions

  1. Identify the topic from the user's question
  2. Check common documentation paths in
    references/documentation-search.md
  3. If path unknown, fetch
    llms.txt
    and search for relevant pages
  4. Convert URL to
    .md
    format and fetch with WebFetch
  5. Extract relevant information and present clearly
  6. Cite the HTML URL (not
    .md
    ) so users can visit

Find Code Examples

  1. Identify the pattern needed (component, trigger, connection type, etc.)
  2. Search
    https://github.com/prismatic-io/examples
    for relevant examples
  3. Fetch raw file content if detailed analysis needed
  4. Present code with explanation
  5. Cite the GitHub URL

Answer "How do I..." Questions

  1. Search docs for conceptual guidance first
  2. Find related examples if code patterns help
  3. Combine documentation and examples for complete answer
  4. Cite both sources when applicable

When to Use This Skill

Use prismatic-docs for:

  • "How do config pages work?"
  • "What connection types are available?"
  • "Best practices for webhook triggers"
  • "How to embed the marketplace"
  • "Setup customer-activated connections"
  • Code pattern examples

Use prismatic-api (not this skill) for:

  • "What integrations do I have?"
  • "List my customers"
  • "Deploy this instance"
  • "Show execution logs"

Common Documentation Paths

TopicPath
Config variables
/docs/config-variables/
Config pages
/docs/config-pages/
Connections
/docs/connections/
Customer config
/docs/customer-configuration/
Custom components
/docs/custom-components/
Code-native integrations
/docs/code-native-integrations/
Embedding marketplace
/docs/embedding-marketplace/
Integration triggers
/docs/integration-triggers/
Instances
/docs/instances/
CLI reference
/docs/cli/
API reference
/docs/api/

See

references/documentation-search.md
for complete paths and task mappings.

Citation Format

Always cite sources so users can learn more:

For documentation:

For more details, see: https://prismatic.io/docs/connections/

For examples:

See the example: https://github.com/prismatic-io/examples/tree/main/components/example-name

Key References

  • references/documentation-search.md
    — Full documentation paths, common tasks mapping, workflows
  • references/example-code.md
    — GitHub examples navigation, search patterns, common categories