Skip to content

feat(appkit): Agent Skills v1 — SKILL.md progressive disclosure + demo (#532) - #544

Open
MarioCadenas wants to merge 5 commits into
mainfrom
split/532/fixtures-docs
Open

feat(appkit): Agent Skills v1 — SKILL.md progressive disclosure + demo (#532)#544
MarioCadenas wants to merge 5 commits into
mainfrom
split/532/fixtures-docs

Conversation

@MarioCadenas

Copy link
Copy Markdown
Collaborator

Summary

Playground/template half of #532 (Agent Skills v1), split 2 of 2. Stacked on #543.

Demo skills exercising every source and case:

  • Global + opt-in: skills/bullet-brief (helper opts in → multi-entry menu on a code agent)
  • Per-agent source: query/skills/routing-brief (+ bundled reference.md, allowed-tools)
  • Collision: per-agent query/skills/haiku vs global haikuagent:haiku / bundle:haiku
  • Template: tracer-bullets skill + planner opt-in
  • /agent page picker gains query so its skills surface in the input

Merge order

Depends on #543 (2/2). Base is split/532/sdk-feature; GitHub auto-retargets this to main once #543 merges.

14 files: apps/dev-playground/* + template/*.

SDK half of #532 (split 1/2). Skills engine (parse/load/resolve/render/read),
agent-definition skills: wiring, agents-plugin integration (load_skill +
read_skill_file tools, catalog resolution, clientConfig), the appkit-ui
useAgentChat /skill surface, and docs. Playground/template fixtures follow in 2/2.

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
template/appkit.plugins.json is generated from the plugin manifests; it must
travel with the agents manifest.json change (skills volume resource) or CI's
sync:template check fails. Was mis-bucketed into the 2/2 fixtures PR.

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
Review follow-ups on #543:
- parallelize UC-volume skill reads (network-bound) via Promise.all; per-skill
  failures still skip individually and sorted order is preserved
- extract the useAgentChat slash-command parse into a named resolveSkill helper (appkit-ui)
- delete 18 stale biome-ignore comments — post-oxlint migration, and no-explicit-any
  is off in .oxlintrc.json, so they suppressed nothing

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
Playground/template half of #532 (split 2/2), stacked on the SDK PR (1/2).
Demo skills exercising every source/case: global bullet-brief (+ helper opt-in),
per-agent query/skills/routing-brief, the agent:haiku/bundle:haiku collision, and
the template tracer-bullets skill. Auto-retargets to main once 1/2 merges.

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
@MarioCadenas
MarioCadenas force-pushed the split/532/fixtures-docs branch from 14b6f9a to 7f79209 Compare August 21, 2026 13:55
react/exhaustive-deps is off in .oxlintrc.json and oxlint doesn't parse
biome directives, so these two suppressions were inert post-migration.

Signed-off-by: MarioCadenas <MarioCadenas@users.noreply.github.com>
@MarioCadenas

Copy link
Copy Markdown
Collaborator Author

Collapsed into #547 (the playground + template skills fixtures are now included there). Closing to keep the skills work as one squash-mergeable PR during my vacation. Commits preserved in #547.

@MarioCadenas MarioCadenas reopened this Aug 21, 2026
@MarioCadenas MarioCadenas changed the title test(playground): Agent Skills demo — playground + template fixtures (2/2 of #532) feat(appkit): Agent Skills v1 — SKILL.md progressive disclosure + demo (#532) Aug 21, 2026
@MarioCadenas
MarioCadenas changed the base branch from split/532/sdk-feature to main August 21, 2026 17:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant