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

# Overview

> Reusable playbooks that specialize your agents.

A skill is a reusable playbook that teaches an [agent](https://docs.os.meetluno.ai/learn/agents/overview.md) how to do a task your way. It is a `SKILL.md` file (plus optional references) with domain-specific instructions the agent loads on demand: your refund policy, your triage rules, your house style, or any other procedure you want to reuse without bloating the system prompt.

Skills live in your project under `src/skills/` and attach to the agents you build.

## Example requests

Ask your coding agent for the procedure or house rules an agent should follow. It can capture them as a skill you reuse across agents.

> "Build a skill for our weekly report format so any agent that writes one follows the same structure and sources."

> "Add a brand voice skill so the marketing agent writes announcements in our house style."

## How skills work

Skills live in your project under `src/skills/`, one folder per skill. Each folder has a `SKILL.md`; you attach the skill to an agent by its folder name.

```
src/skills/support/
  SKILL.md
  references/refund-policy.md   # optional
```

```ts src/agents/support.ts theme={null}
import { defineAgent } from "@meetluno/luno/agent";

export default defineAgent({
  slug: "support",
  name: "Support",
  description: "Answers support questions using the support skill.",
  systemPrompt: "Answer support questions with clear, concise replies.",
  model: "zai/glm-5.2",
  skills: ["support"],
});
```

Before a prompt runs, Luno OS materializes attached skills into the agent's shared workspace at `/workspace/agent/skills/{slug}/`, advertises them in the system prompt, and exposes `skill_view` so the agent can load `SKILL.md` (and packed references) on demand. Keep clones and package installs out of `/workspace/agent` — that shared filesystem is for skills, files, and other cross-session shares. See [Sandboxes](https://docs.os.meetluno.ai/learn/agents/build-agents.md#sandboxes).

## When to use a skill

| Use a skill for | Use something else for |
| - | - |
| Reusable, on-demand guidance an agent reads when relevant | Always-needed, short instructions → `systemPrompt` |
| Multi-section playbooks, policies, and procedures | Static reference docs the agent should read → [files](https://docs.os.meetluno.ai/learn/files/overview.md) |
| Behavior shared across prompts or agents | A discrete capability or API call → an [action](https://docs.os.meetluno.ai/learn/actions/overview.md) |

Skills and [files](https://docs.os.meetluno.ai/learn/files/overview.md) both materialize into the workspace, but they play different roles: a skill is *instructions* (how to do something), while a file is *context* (a document to read).

## Next steps

> **[Create skills](https://docs.os.meetluno.ai/learn/skills/create-skills.md)**
>
> Write a SKILL.md with clear task guidance.

> **[Attach skills to agents](https://docs.os.meetluno.ai/learn/skills/attach-skills-to-agents.md)**
>
> Attach skills to an agent by folder name.

> **[Import skills](https://docs.os.meetluno.ai/learn/skills/import-skills.md)**
>
> Reuse skills from external registries.

> **[Files](https://docs.os.meetluno.ai/learn/files/overview.md)**
>
> Add static context documents to an agent workspace.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.