Skip to content

docs: clarify inline metadata-only skill scope #435

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
ketpatil77 wants to merge 1 commit into from
+3 −1
Closed

docs: clarify inline metadata-only skill scope #435

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apps/docs/src/content/docs/api/agent-api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ type Skill =
};
```

Skill metadata registered with an agent, harness, or profile. Imported `SkillReference` values bundle application-owned skill content. Inline metadata adds only a named catalog entry; it does not package or inject an instruction body. Initialization rejects a registered skill whose name collides with a workspace-discovered skill. See [Skills](/docs/guide/skills/).
Skill metadata registered with an agent, harness, or profile. Imported `SkillReference` values bundle application-owned skill content. Inline metadata adds only a named catalog entry: it is visible in the skill catalog, but it does not package `SKILL.md`, inject instructions, or load supporting files. Use imported or workspace-discovered skills when you need reusable behavior. Initialization rejects a registered skill whose name collides with a workspace-discovered skill. See [Skills](/docs/guide/skills/).

## `defineTool(...)`

Expand Down
2 changes: 2 additions & 0 deletions apps/docs/src/content/docs/guide/skills.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,8 @@ Each discovered skill is available by its declared name without a TypeScript imp

If an imported skill registered on an agent and a discovered workspace skill declare the same name, initialization fails rather than choosing one implicitly.

Flue also accepts inline skill metadata in `skills: [{ name, description }]`, but that form only registers a catalog entry. It does not package `SKILL.md`, and it does not inject reusable skill instructions or supporting files. Use imported skills or workspace-discovered skills when you want real reusable behavior.

## Frontmatter support

Flue validates every `SKILL.md` against the [Agent Skills specification](https://agentskills.io/specification), whether the skill is imported or discovered in a workspace. The table below lists Flue's support level for each frontmatter field:
Expand Down
Loading