Skip to main content

Documentation Index

Fetch the complete documentation index at: https://redop.useagents.site/docs/llms.txt

Use this file to discover all available pages before exploring further.

Agent Skills

AI-ready Redop knowledge for assistants that need to explain, design, debug, and build MCP servers with Redop.
Redop includes an installable Agent Skill that teaches compatible AI assistants how Redop works. It packages framework knowledge, design guidance, example patterns, and practical prompts so the assistant can help with Redop tasks without depending on a local Redop checkout.

What are Agent Skills?

Agent Skills is an open specification for packaging AI assistant capabilities. Skills can ship:
  • Framework knowledge: core Redop concepts, lifecycle, transports, and composition patterns
  • Design guidance: when to use tools, resources, prompts, middleware, hooks, modules, and plugins
  • Implementation help: examples and prompts for building or debugging a Redop server

Available Skill

SkillDescription
skills/redopPortable Redop framework knowledge for understanding, building, debugging, and extending Bun-first TypeScript MCP servers.

Installing the Skill

Compatible agents can discover and use skills automatically. To install the Redop skill with the skills CLI:
[Terminal]
bunx skills add redopjs/skills

What the Skill Does

Framework Explanation

The skill teaches assistants:
  • what Redop is and when it is a good fit
  • the Redop mental model and explicit composition style
  • how tools, resources, and prompts differ
  • how the request lifecycle works from derive through afterResponse

Design Guidance

The skill helps assistants answer questions such as:
  • when to model something as a tool vs a resource vs a prompt
  • when to use middleware vs hooks
  • when to use .use(...) with feature modules vs extracting a plugin
  • when to scaffold with create-redop-app vs install @redopjs/redop directly

Build and Debug Help

The skill includes guidance for:
  • building a first Redop server
  • adding typed input with Zod and other supported schema styles
  • choosing HTTP vs stdio transport
  • understanding plugin-based typed request context
  • debugging transport, lifecycle, and error-handling questions

Example Prompts

Ask your AI assistant:

Skill Structure

skills/
└── redop/
    ├── SKILL.md
    ├── agents/
    │   └── openai.yaml
    └── references/
        ├── foundations.md
        ├── surfaces.md
        ├── runtime.md
        ├── composition.md
        ├── transports.md
        ├── scaffolding.md
        └── examples.md

Reference Documents

The Redop skill ships with focused references:

foundations.md

  • what Redop is
  • the core mental model
  • when to choose Redop
  • constructor and request-context basics

surfaces.md

  • tool, resource, and prompt design
  • schema usage
  • annotations
  • handler contracts

runtime.md

  • request execution order
  • middleware and hooks
  • error behavior
  • after-response work

composition.md

  • feature modules
  • plugins
  • typed context propagation
  • built-in auth and logging helpers

transports.md

  • listen() shapes
  • HTTP vs stdio
  • /mcp
  • session behavior and transport caveats

scaffolding.md

  • create-redop-app
  • install-vs-scaffold decisions
  • starter defaults
  • transport, schema, and deploy choices

examples.md

  • portable example patterns
  • optional deep-dive pointers when a Redop checkout is available

Next Steps