Skip to content

chore(mule-development): add generate-connectivity-knowledge skill, bump to 1.3.0#144

Merged
bpolat1 merged 2 commits into
mulesoft:masterfrom
matiasjlopez:feat/W-22567718-generate-connectivity-knowledge
Jun 23, 2026
Merged

chore(mule-development): add generate-connectivity-knowledge skill, bump to 1.3.0#144
bpolat1 merged 2 commits into
mulesoft:masterfrom
matiasjlopez:feat/W-22567718-generate-connectivity-knowledge

Conversation

@matiasjlopez

Copy link
Copy Markdown
Contributor

Summary

  • Add generate-connectivity-knowledge — a new 14-step skill that produces connectivity knowledge for a SaaS API when no dedicated Mule connector exists. Researches the API from user-defined use cases and documentation, produces an OpenAPI 3.0 spec, validates every operation against the live service with auto-fix, and writes a self-contained connectivity-schema/<apiName>/ folder (api-reference.md + <apiName>.yaml + config.properties).
  • The output feeds the HTTP-fallback branch of build-mule-integration (Step 3a) so HTTP-Connector flows inherit the same auth, pagination, and entity awareness a dedicated connector would carry.
  • Bump @salesforce/mulesoft-vibes-skills from 1.2.01.3.0 (minor bump for a new skill, per semver) and add the corresponding CHANGELOG.md entry.

What's in the skill

File Purpose
generate-connectivity-knowledge/SKILL.md The 14-step workflow: research → OpenAPI 3.0 generation → live validation with auto-fix.
generate-connectivity-knowledge/references/examples.md Worked examples for the most common patterns the agent encounters during research and validation.

The skill includes MANDATORY credential-security rules: never read, echo, log, or reason about credential values from config.properties. Verification is via grep -c '^KEY=' and injection via inline shell substitution; the values never enter the agent's transcript.

Test plan

  • make pre-commit-hookvalidate-descriptions, validate-mcp-server, validate-xorigin, validate-jtbd, validate-skills PASS
  • make test-portal — pytest + jest PASS
  • make validate-all-governed — PASS (run via pre-push hook on this branch)
  • python3 scripts/build/validate_jtbd.py skills/mule-development/generate-connectivity-knowledge/SKILL.md . — PASSED

Notes for reviewers

Out of scope

  • Wiring build-mule-integration Step 3a to invoke the new skill — ships in a follow-up PR.

GUS

@W-22567718

@matiasjlopez matiasjlopez force-pushed the feat/W-22567718-generate-connectivity-knowledge branch from de84803 to 034fb74 Compare June 23, 2026 18:48
Adds a 14-step skill that produces connectivity knowledge for any SaaS
API: research → OpenAPI 3.0 spec → live validation with auto-fix. Output
is a self-contained connectivity-schema/<apiName>/ folder (api-reference.md
+ <apiName>.yaml + config.properties) suitable for any downstream consumer
that needs API metadata.

Wiring into build-mule-integration ships in a follow-up PR.
…ctivity-knowledge

Cuts the release for the new generate-connectivity-knowledge skill added in
the previous commit. No code changes — version + lockfile + CHANGELOG only.
Minor bump (1.3.0 -> 1.4.0) per semver for a new skill addition.
@matiasjlopez matiasjlopez force-pushed the feat/W-22567718-generate-connectivity-knowledge branch from 034fb74 to bbc6c1b Compare June 23, 2026 18:53
@bpolat1 bpolat1 merged commit b672083 into mulesoft:master Jun 23, 2026
8 checks passed
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