Skip to content
Last updated

skills

Products:RedocRedocRevelRevelReefReefRealmRealm
Plans:ProEnterpriseEnterprise+

By default, Realm publishes every agent skill in your project for agents to discover. Use the skills configuration to hide skills or exclude specific files from discovery.

Options

OptionTypeDescription
hidebooleanStop publishing agent skills. When set to true, the skills index, the per-skill files, and the agent card return 404, and skills are omitted from the MCP resources. Default: false.
excludeFiles[string]Glob patterns matched against each skill's project-relative path. A skill whose path matches any pattern is excluded from discovery — the skills index, the agent card, and the MCP resources. A direct request for its SKILL.md returns 404. Default: []

Examples

Exclude specific skills

Exclude staff-only runbooks from discovery while publishing the rest:

skills:
  excludeFiles:
    - '@skills/internal/**'

Hide all skills

Stop publishing every skill without removing the @skills folder:

skills:
  hide: true

Default configuration

skills:
  hide: false
  excludeFiles: []

Resources

  • Agent skills - Author SKILL.md files and understand the discovery endpoints that publish them
  • mcp configuration - Configure the Docs MCP server that exposes skills as resources
  • Configuration options - Explore other project configuration options for comprehensive documentation and platform customization

ssoDirect