Skip to content

@W-22137891 Add Prose only Skill & clean up - #22

Merged
Ferticidio merged 4 commits into
masterfrom
chores/W-22137891-CleanUpSkills
Apr 22, 2026
Merged

@W-22137891 Add Prose only Skill & clean up#22
Ferticidio merged 4 commits into
masterfrom
chores/W-22137891-CleanUpSkills

Conversation

@Ferticidio

Copy link
Copy Markdown
Contributor

Summary

  • Add infrastructure for prose-only skills (no API operation steps) — validator, discovery, generator, and templates all support skills without ## Step N: sections
  • Create anypoint-platform-operations skill: a prose-only guide teaching agents how to use the dev portal as the source of truth (llms.txt, AGENTS.md, registry.json, x-origin,
    JTBD)
  • Remove 5 test skills: deploy-api-to-managed-flex-gateway-from-exchange, deploy-api-with-rate-limiting, list-organization-api-instances, manage-consumer-contracts,
    setup-multi-upstream-routing
  • Fix install skill command URL to point to mulesoft/mulesoft-dx
  • Enable markdown-it table plugin for skill content rendering
  • Render additional skill sections (Tips, Troubleshooting, Related Jobs) in skill detail pages

Introduce a new skill category for prose-only guides (no API operation
steps) and create the first one: discover-anypoint-platform-apis, which
teaches agents how to use the dev portal as the source of truth via
llms.txt, AGENTS.md, registry.json, x-origin, and JTBD skills.

Infrastructure changes:
- Validator allows skills with 0 step headers and 0 YAML blocks
- Discovery returns all skills including those with no API refs
- Generator collects prose-only skills into the portal catalog
- Skill page hides interactive mode toggle for prose-only skills
- Sidebar shows section anchors instead of empty steps panel
- Skill detail template renders tips, troubleshooting, related jobs
- Enable markdown-it table plugin for skill content rendering
Update the install command URL from the old anypoint-dev-portal repo
to mulesoft-dx.
Remove 5 skills that were created for testing purposes:
- deploy-api-to-managed-flex-gateway-from-exchange
- deploy-api-with-rate-limiting
- list-organization-api-instances
- manage-consumer-contracts
- setup-multi-upstream-routing
@Ferticidio
Ferticidio requested a review from a team as a code owner April 22, 2026 13:43
@Ferticidio
Ferticidio merged commit df61cda into master Apr 22, 2026
9 checks passed
@Ferticidio
Ferticidio deleted the chores/W-22137891-CleanUpSkills branch May 7, 2026 17:22
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