Skip to content

feat: add apimatic sdk skill#2

Open
Ayeshas09 wants to merge 7 commits intomainfrom
feat/add-apimatic-sdk-skill
Open

feat: add apimatic sdk skill#2
Ayeshas09 wants to merge 7 commits intomainfrom
feat/add-apimatic-sdk-skill

Conversation

@Ayeshas09
Copy link
Copy Markdown

Adds a new skill for generating, customizing, and managing SDKs using the APIMatic CLI.

What's included:

  • SKILL.md having full workflow covering auth, generation, CodeGen settings via APIMATIC-META.json, and change tracking for customizations
  • Reference files for all CodeGen setting categories (timeout, branding, endpoints, serialization, etc.)
  • First-time setup guide and save-changes workflow
  • Example flows
  • Eval suite

@Ayeshas09 Ayeshas09 self-assigned this Apr 23, 2026
@Ayeshas09 Ayeshas09 requested a review from sohaibtariq April 23, 2026 11:00
Copy link
Copy Markdown
Collaborator

@sohaibtariq sohaibtariq left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR Review: apimatic-sdk skill

The skill is well-architected overall — strong eval suite (41 cases), clean progressive disclosure, and the 14-item red flags section is the best part of the SKILL.md. Two blocking issues need resolution before merge.

Blocking:

  • B1. Missing scripts/auth-login.mjs — runtime failure on first use (see inline comment)
  • B2. --track-changes contradicts between SKILL.md and the example file (see inline comments)

Suggestion:

  • I3. Add a publishing example file to examples/ (see inline comment)

Details inline below.

Additionally, in terms of the structure of SKILLs.md, it might make sense to have 3 sections:

  • Generate an SDK
  • Customize an SDK
  • Publish an SDK

The last 2 are covered, but the first isn't explicitly mentioned, although it is implied in both of the sections.
Do you think we need to have a separate SDK generation section ?

Comment thread skills/apimatic-sdk/SKILL.md
Comment thread skills/apimatic-sdk/SKILL.md
Comment thread skills/apimatic-sdk/examples/generate-customize-save.md Outdated
Comment thread skills/apimatic-sdk/SKILL.md Outdated
@Ayeshas09
Copy link
Copy Markdown
Author

PR Review: apimatic-sdk skill

The skill is well-architected overall — strong eval suite (41 cases), clean progressive disclosure, and the 14-item red flags section is the best part of the SKILL.md. Two blocking issues need resolution before merge.

Blocking:

  • B1. Missing scripts/auth-login.mjs — runtime failure on first use (see inline comment)
  • B2. --track-changes contradicts between SKILL.md and the example file (see inline comments)

Suggestion:

  • I3. Add a publishing example file to examples/ (see inline comment)

Details inline below.

Additionally, in terms of the structure of SKILLs.md, it might make sense to have 3 sections:

  • Generate an SDK
  • Customize an SDK
  • Publish an SDK

The last 2 are covered, but the first isn't explicitly mentioned, although it is implied in both of the sections. Do you think we need to have a separate SDK generation section ?

Reagrding the last point, the generation steps were already there, I've grouped them under a Generate an SDK heading and added a note that these same steps apply when initializing change tracking during a customization workflow. So now all the three sections are explicitly covered.

@asadali214 asadali214 requested a review from sohaibtariq May 5, 2026 16:49
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