{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs-realm.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["configOptionRequirements"]},"redocly_category":"Realm","type":"markdown"},"seo":{"title":"skills","description":"OpenAPI-generated documentation tool with 24k+ stars on Github - make APIs your company's superpower.","siteUrl":"https://redocly.com","image":"/assets/redocly-card.f670aae34a39545a5ea633a540cb3a4a333a1f23bb2ed3c4a1b17a5fbcf0ac85.db81178d.png","lang":"en-US"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"skills","__idx":0},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skills"]}]},{"$$mdtype":"Tag","name":"ConfigOptionRequirements","attributes":{"products":["Redoc","Revel","Reef","Realm"],"plans":["Pro","Enterprise","Enterprise+"]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, Realm publishes every ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/realm/customization/agent-skills"},"children":["agent skill"]}," in your project for agents to discover."," ","Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["skills"]}," configuration to hide skills or exclude specific files from discovery."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"options","__idx":1},"children":["Options"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["hide"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stop publishing agent skills."," ","When set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the skills index, the per-skill files, and the agent card return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]},", and skills are omitted from the MCP resources."," ","Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["excludeFiles"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["[string]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKILL.md"]}," returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]},"."," ","Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":2},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"exclude-specific-skills","__idx":3},"children":["Exclude specific skills"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Exclude staff-only runbooks from discovery while publishing the rest:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"skills:\n  excludeFiles:\n    - '@skills/internal/**'\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hide-all-skills","__idx":4},"children":["Hide all skills"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Stop publishing every skill without removing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@skills"]}," folder:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"skills:\n  hide: true\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"default-configuration","__idx":5},"children":["Default configuration"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"skills:\n  hide: false\n  excludeFiles: []\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":6},"children":["Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/realm/customization/agent-skills"},"children":["Agent skills"]}]}," - Author ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SKILL.md"]}," files and understand the discovery endpoints that publish them"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/realm/config/mcp"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp"]}," configuration"]}]}," - Configure the Docs MCP server that exposes skills as resources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/realm/config"},"children":["Configuration options"]}]}," - Explore other project configuration options for comprehensive documentation and platform customization"]}]}]},"headings":[{"value":"skills","id":"skills","depth":1},{"value":"Options","id":"options","depth":2},{"value":"Examples","id":"examples","depth":2},{"value":"Exclude specific skills","id":"exclude-specific-skills","depth":3},{"value":"Hide all skills","id":"hide-all-skills","depth":3},{"value":"Default configuration","id":"default-configuration","depth":2},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"products":["Redoc","Revel","Reef","Realm"],"plans":["Pro","Enterprise","Enterprise+"],"description":"Control how agent skills are published from your project.","seo":{"title":"skills"}},"lastModified":"2026-07-14T14:31:10.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/realm/config/skills","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}