# MCP Documentation Resources Reference

> Markdown variant of <https://www.skillzdrive.com/docs/reference/resources>.

Read skill documentation efficiently using the documentation tools.

## What are resources?

Resources are the documentation and reference files bundled with
each skill. They describe what the skill does, how to use it, and
include examples. You access them through three documentation
tools — you never need to construct URIs manually.

## Reading documentation

Use `skills_docTOC` to see what sections are available, then
`skills_docSection` to read the ones you need.

### Step 1: Get the table of contents

```json
{
  "name": "skills_docTOC",
  "arguments": { "skillSlug": "docx" }
}
```

Response:

```json
{
  "sections": [
    { "slug": "overview", "title": "Overview", "level": 1 },
    { "slug": "creating-documents", "title": "Creating Documents", "level": 2 },
    { "slug": "formatting", "title": "Formatting", "level": 2 },
    { "slug": "tables", "title": "Tables", "level": 2 }
  ]
}
```

### Step 2: Read a specific section

```json
{
  "name": "skills_docSection",
  "arguments": { "skillSlug": "docx", "sectionSlug": "tables" }
}
```

Read individual sections instead of full documentation. This keeps
token usage low and responses focused.

## Checking file metadata

Use `skills_getResourceInfo` to check a file's size, token count,
and available sections before reading it. This helps you decide
whether to read the full file or target specific sections.

```json
{
  "name": "skills_getResourceInfo",
  "arguments": { "skillSlug": "docx", "filePath": "references/formatting.md" }
}
```

Response:

```json
{
  "sections": ["Tables", "Fonts", "Margins", "Headers and Footers"],
  "tokenCount": 1200,
  "fileSize": 4096,
  "contentType": "text/markdown"
}
```

## Reading raw resource content

`skills_readResourceContent` returns the raw bytes of a resource
file (full or by section name). Blocked for premium skills.

```json
{
  "name": "skills_readResourceContent",
  "arguments": {
    "skillSlug": "docx",
    "filePath": "references/formatting.md",
    "sectionName": "Tables"
  }
}
```

## Token efficiency guide

Different approaches have different token costs. Use the most
targeted tool to minimize context window usage.

| Tool | Token cost | When to use |
|------|------------|-------------|
| `docTOC` | Low | First step — see what's available |
| `getResourceInfo` | Low | Check size and sections before reading |
| `docSection` | Medium | Read one specific section |
| Multiple `docSection` calls | High | Only when you need several sections |

## Next steps

- [MCP tools reference](https://www.skillzdrive.com/docs/reference/tools.md): every `skills_*` tool with arguments.
- [Discovering skills](https://www.skillzdrive.com/docs/guides/discovering-skills.md).