# Skill documents: shared team instructions for every AI tool

> Falconer Skill documents let teams create, share, manage, and reuse AI instructions across Falconer and MCP-connected tools like Claude, Cursor, and Codex.

- Date: 2026-06-03
- Author: Lilu Xu
- Tags: product, ai, documentation

---
Reusable AI instructions are becoming part of how teams work. An engineer might want a PR review checklist. A PM might want a launch note template. A support lead might want a reliable way to summarize an escalation.

Too often, those instructions live in private prompt snippets, local files, or one person's memory. They work for the person who made them, but they do not become part of the team.

**Skill documents** turn those instructions into shared Falconer knowledge. A skill is a normal Falconer document marked as **Type: Skill**. Once it is marked as a skill, teammates can invoke it in Falconer chat, and MCP-connected tools can load it as an instruction prompt.

## What is a Skill document?

A Skill document starts like any other Falconer doc. You write it in the editor, organize it with the rest of your team knowledge, share it with the right people, and update it as the workflow changes. The only extra step is setting the document type to **Skill** in the Details panel.

That marker changes how the document behaves. It still reads like a document, but Falconer also treats it as reusable agent context. In chat, type `/` or use the **Skills** option to pick a skill. The selected skill appears as a distinct reference chip and is passed to the model as `<skill>` context, so the agent knows it is receiving instructions to follow, not just background reading.

<figure style="margin: 1.25rem 0 2rem;">
  <video controls playsinline preload="metadata" style="width: 100%; border-radius: 12px;">
    <source src="/videos/notes-skill-docs.mp4" type="video/mp4" />
    Your browser does not support the video tag.
  </video>
  <figcaption style="text-align: center; font-size: 0.875rem; opacity: 0.6; margin-top: 0.5rem;">
    Starting a new doc with a skill.
  </figcaption>
</figure>

## Use the same skill across tools

Falconer skills are not limited to falconer.com. Through Falconer MCP, visible Skill documents are exposed as native MCP prompts, so AI clients like Claude.ai, Claude Code, Cursor, and Codex CLI can load the same team-authored skill from Falconer.

<figure style="margin: 1.25rem 0 2rem;">
  <video controls playsinline preload="metadata" style="width: 100%; border-radius: 12px;">
    <source src="/videos/notes-skill-claude-ai.mp4" type="video/mp4" />
    Your browser does not support the video tag.
  </video>
  <figcaption style="text-align: center; font-size: 0.875rem; opacity: 0.6; margin-top: 0.5rem;">
    Using a Falconer skill in Claude.ai.
  </figcaption>
</figure>

The same launch-note skill can be used in Falconer chat. The same frontend-review skill can be used from a coding agent. The same customer-handoff skill can be loaded by a teammate working in a different AI client.

The source stays in Falconer. The skill travels to where the work is happening.

## Skills are for the whole team

Skills should not only be for engineers. Technical teammates can write skills for deployment reviews, debugging workflows, architecture explanations, incident response, or repo-specific coding conventions.

Non-technical teammates can write skills too. A PM can write one for turning customer feedback into a product brief. A support lead can write one for escalation summaries. A marketer can write one for launch notes.

The important part is that creating a skill is writing a document, not shipping code. If someone understands a repeatable workflow, they can turn it into a skill.

## One shared skill library

Because skills are Falconer documents, they inherit the document system around them. They can be shared with individuals, groups, or the whole organization. They can have authors and owners. They show up in search. They live alongside the docs, runbooks, decisions, and processes they depend on. They have document history and restorable versions, so a team can improve a skill over time without losing where it came from.

That makes skills a managed team library instead of a pile of disconnected prompts.

When a workflow changes, the team updates the skill once. When a new teammate joins, they can find and use the same skill. When someone improves the instruction, everyone benefits from the better version.

## Try it

Create a Falconer document for a workflow your team repeats. Write the instruction clearly enough that another teammate could follow it. Share it with the people who should use or maintain it. Then open the Details panel and set **Type** to **Skill**.

<figure style="max-width: 360px; margin: 1.25rem auto 2rem;">
  <img
    src="/docs/images/create-skill-doc-details.png"
    alt="Falconer Details panel showing Type set to Skill"
    style="width: 100%; border-radius: 12px;"
  />
  <figcaption style="text-align: center; font-size: 0.875rem; opacity: 0.6; margin-top: 0.5rem;">
    Set the document type to Skill from the Details panel.
  </figcaption>
</figure>

For the step-by-step flow, see Falconer's [Create a skill doc](/docs/use-cases/generate-documents/create-a-skill-doc) guide.