> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stagewise.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills & context files configuration

> Configure workspace-specific skills and context files for stagewise AI coding agents. Generate WORKSPACE.md, create SKILL.md files, and manage agent context per workspace.

Open **Settings → Agent → Skills & Context files**.

<img src="https://mintcdn.com/stagewiseinc/yOk2iKqLyNP2SwWs/images/docs/skills-context.webp?fit=max&auto=format&n=yOk2iKqLyNP2SwWs&q=85&s=9ccfc269bd421f0e8184d0c50b3ed03c" alt="Skills and Context files settings showing per-workspace skills with enable and disable toggles" width="3054" height="1922" data-path="images/docs/skills-context.webp" />

*Enable or disable skills per workspace so each agent follows the right project-specific instructions.*

## WORKSPACE.md

stagewise auto-generates a `WORKSPACE.md` file in `.stagewise/` for each workspace. It contains structured project analysis and is kept up to date across sessions.

### Generate or update WORKSPACE.md

1. Open **Settings → Agent → Skills & Context files**
2. Select the workspace
3. Click **Generate** (or **Regenerate** to update)

The file is written to `.stagewise/WORKSPACE.md` in your project root. Commit it to source control.

## AGENTS.md

An optional `AGENTS.md` file in your project root provides custom instructions — coding conventions, preferred libraries, project terminology.

<Warning>
  AGENTS.md is opt-in and disabled by default. It can get outdated and mislead the agent. Use skills instead for project-specific instructions.
</Warning>

Enable it per workspace in the Skills & Context settings.

## Skills

Skills are `SKILL.md` files that extend the agent with structured instructions for specific tasks. [Learn the concepts →](/core-concepts/skills-and-plugins)

### Skill locations

Skills load from two places in priority order:

| Location             | Priority |
| -------------------- | -------- |
| `.stagewise/skills/` | Highest  |
| `.agents/skills/`    | Lower    |

### Enable or disable skills

In **Settings → Agent → Skills & Context files**, toggle individual skills on or off per workspace. Disabled skills are ignored even if the files exist on disk.

### Create a skill

Create a folder with a `SKILL.md` file:

```markdown theme={null}
---
name: "my-skill"
description: "When and how the agent should use this skill."
---

# Instructions

Your structured instructions here...
```

The `description` field tells the agent when to activate the skill. Be specific:

```markdown theme={null}
---
name: "tailwind-patterns"
description: "Use when creating or modifying React components styled with Tailwind CSS."
---

# Instructions

Always use design tokens from `theme.ts`, never hardcoded colors.
Components should accept a `className` prop and merge it with defaults.
```

### Skill folder structure

```
.stagewise/skills/my-skill/
├── SKILL.md          # Instructions (required)
├── references/       # Files the agent can read
└── assets/           # Supporting files
```

Scripts in the `scripts/` folder are read-only — the agent can reference but not execute them.

## Related

* [Skills & plugins concept →](/core-concepts/skills-and-plugins)
* [Plugins reference →](/reference/plugins)