# `skills`

By default, Realm publishes every [agent skill](/docs/realm/customization/agent-skills) in your project for agents to discover.
Use the `skills` configuration to hide skills or exclude specific files from discovery.

## Options

| Option | Type | Description |
|  --- | --- | --- |
| hide | boolean | Stop 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:

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

### Hide all skills

Stop publishing every skill without removing the `@skills` folder:

```yaml
skills:
  hide: true
```

## Default configuration

```yaml
skills:
  hide: false
  excludeFiles: []
```

## Resources

- **[Agent skills](/docs/realm/customization/agent-skills)** - Author `SKILL.md` files and understand the discovery endpoints that publish them
- **[`mcp` configuration](/docs/realm/config/mcp)** - Configure the Docs MCP server that exposes skills as resources
- **[Configuration options](/docs/realm/config)** - Explore other project configuration options for comprehensive documentation and platform customization