Skip to content

feat: unadvertised skills via advertise: false#1984

Merged
ammario merged 1 commit intomainfrom
skills-qc9t
Jan 31, 2026
Merged

feat: unadvertised skills via advertise: false#1984
ammario merged 1 commit intomainfrom
skills-qc9t

Conversation

@ammar-agent
Copy link
Collaborator

@ammar-agent ammar-agent commented Jan 28, 2026

Summary

Add support for unadvertised skills via advertise: false in skill frontmatter.

Unadvertised skills:

  • Are not listed in the tool description's skill index (reducing token overhead)
  • Can still be invoked via /{skill-name} slash command or agent_skill_read({ name: "skill-name" })
  • Still appear in Mux's UI lists (e.g., / slash suggestions)
  • Are useful for: internal orchestration skills, sub-agent-only skills, or power-user workflows

Changes

Schema & filtering

  • Add advertise: z.boolean().optional() to AgentSkillFrontmatterSchema and AgentSkillDescriptorSchema
  • Filter skills with advertise: false from the tool description in agent_skill_read.ts

UI

  • Add EyeOff icon indicator in SkillIndicator for unadvertised skills
  • Add full-app story (SkillIndicator_UnadvertisedSkills) in App.agentSkills.stories.tsx

Example skill

  • Add deep-review as a project skill (.mux/skills/deep-review/SKILL.md)
  • A sub-agent-powered code review workflow spanning correctness, tests, consistency, UX, and performance
  • Invoke with /deep-review for thorough, parallelized reviews

Documentation

  • Document the advertise field in docs/agents/agent-skills.mdx
  • Add docs generator support for deep-review skill content sync

Test plan

  • make static-check passes
  • Skill tests pass (bun test --grep skill)
  • Manual: /deep-review slash command loads the skill and provides review guidance
  • Story: SkillIndicator_UnadvertisedSkills shows EyeOff icons for unadvertised skills

Add support for skills that should not be advertised in the tool description
but remain invocable via /skill-name or agent_skill_read.

Changes:
- Add `advertise` field to AgentSkillFrontmatterSchema and AgentSkillDescriptorSchema
- Filter skills with `advertise: false` from tool description in agent_skill_read.ts
- Add EyeOff icon indicator in SkillIndicator for unadvertised skills
- Add deep-review skill as project skill (.mux/skills/deep-review/SKILL.md)
- Add full-app story for SkillIndicator with unadvertised skills
- Document the feature in docs/agents/agent-skills.mdx
- Add docs generator support for deep-review skill content sync
@ammario ammario merged commit 6737991 into main Jan 31, 2026
23 checks passed
@ammario ammario deleted the skills-qc9t branch January 31, 2026 18:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation enhancement New feature or functionality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants