Agent Skill · Prismatic

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.

Provider: Prismatic Path in repo: plugin/skills/prismatic-docs/SKILL.md

Skill body

Prismatic Documentation

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

Resources

Core Technique: Markdown Fetch

Prismatic docs pages serve clean markdown by appending .md to the URL path:

HTML URL Markdown 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.

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:

Use prismatic-api (not this skill) for:

Common Documentation Paths

Topic Path
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

Skill frontmatter

version: 1.0.0 user-invocable: false