Skip to content

docs(skills): tighten 11 skill descriptions + visibility priority on the two root entry points - #107

Merged
Brian Krabach (bkrabach) merged 2 commits into
mainfrom
skill-visibility-desc
Aug 30, 2026
Merged

docs(skills): tighten 11 skill descriptions + visibility priority on the two root entry points#107
Brian Krabach (bkrabach) merged 2 commits into
mainfrom
skill-visibility-desc

Conversation

@bkrabach

Copy link
Copy Markdown
Collaborator

What

Tightens skill descriptions across the context-intelligence bundle and marks the two root-session entry points for high visibility in the token-budget catalog.

Changes:

  • Descriptions tightened across 11 skills
  • 3 hogs cut to ≤400 chars, every quoted trigger question kept verbatim
  • visibility: {priority: 5, summary} added to:
    • context-intelligence-graph-query (root-session NL entry point)
    • workflow-pattern-analysis (root-session NL entry point)
  • Other 9 skills are agent-loaded internals, left unprioritized

Validation:

  • Frontmatter-only changes
  • YAML verified 11/11

Related To

See amplifier-bundle-skills PR for the token-budget catalog mechanism (link after both exist).

…high-visibility

- Tighten verbose descriptions across 11 SKILL.md files: move routing phrases
  ("Use when...", quoted trigger strings, tool/agent names) earlier and cut
  repetition, per editorial contract.
- derived-metrics, gds, and workflow-pattern-analysis (the worst offenders at
  ~600-670 chars) reduced to ~380-400 chars while preserving every distinct
  trigger phrase and tool/agent reference.
- Add visibility.priority: 5 (+ curated visibility.summary) to
  context-intelligence-graph-query and workflow-pattern-analysis, the two
  root-session natural-language entry points into this bundle. No other
  skill's visibility is set.
- No changes to name, version, shortcut, user-invocable, or
  disable-model-invocation on any skill.
@bkrabach
Brian Krabach (bkrabach) merged commit 75249aa into main Aug 30, 2026
7 checks passed
@bkrabach
Brian Krabach (bkrabach) deleted the skill-visibility-desc branch August 30, 2026 11:00
@bkrabach

Copy link
Copy Markdown
Collaborator Author

Mechanism: microsoft/amplifier-bundle-skills#63 (token-budget catalog)

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.

2 participants