[supriya-parallel]

Summary

• add the choose-your-parallel-api skill for choosing the right Parallel API and configuration
• include tier and configuration guidance for latency, cost, and quality tradeoffs
• expose the skill through the catalog, README, and .agents/skills discovery symlink

Documentation

The companion docs change is shapleyai/documentation#731. Merge this PR first so its hosted skill and source links resolve.

Validation

• skill quick validation
• pnpm typecheck
• pnpm build
• pnpm build:archives -- --version 0.9.0 --output release-assets
• markdownlint

The generated catalog entry uses npx skills add parallel-web/parallel-agent-skills --skill choose-your-parallel-api.

[sergei1152]

what do we want to get out of this skill? once the agent figures out the api, what next? (these skills are installed with parallel-cli so high intent users that already know about parallel).

maybe this fits into as a skill in our cookbook repo? I'm working on enabling skills there

[supriya-parallel]

This is supposed to help first time users with their configuration and setup - in some cases I think it might also be used to set up/configure APIs for evals if customers are doing them on their own. I think it could be useful in the cli as a first touch point to guide users toward an API - we hear and see often from customers that they start in the wrong place with misconfiguration.

…

On Fri, Sep 11, 2026 at 6:01 PM Serj Babayan ***@***.***> wrote: *sergei1152* left a comment (parallel-web/parallel-agent-skills#54) <#54 (comment)> what do we want to get out of this skill? once the agent figures out the api, what next? (these skills are installed with parallel-cli so high intent users that already know about parallel). maybe this fits into as a skill in our cookbook repo? I'm working on enabling skills there — Reply to this email directly, view it on GitHub <#54?email_source=notifications&email_token=CHX6ZFIIZ4PDCDZQXNIBFQ35ORY4BA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKNRUGEYTEOBQHAZ2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#issuecomment-5641128083>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/CHX6ZFOUUP5J3AJURPENI335ORY4BAVCNFSNUABGKJSXA33TNF2G64TZHMYTCNJRGY3DKMJUGI5US43TOVSTWNJUGI4TCMBQHE2TPILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/CHX6ZFJI7GT5HWEP73CL5Y35ORY4BA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKNRUGEYTEOBQHAZ2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/CHX6ZFL6ZDM3YVQDBMRWKUD5ORY4BA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKNRUGEYTEOBQHAZ2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>

[georgeatparallel]

what do we want to get out of this skill? once the agent figures out the api, what next? (these skills are installed with parallel-cli so high intent users that already know about parallel).

maybe this fits into as a skill in our cookbook repo? I'm working on enabling skills there

yeah, good point on what happens after it picks the API. I added a section so if someone’s asking to build an integration, it keeps going through implementation and verification. If they just want advice, it gives them the recommendation and relevant quickstart.

I’d lean toward keeping it here alongside migrate-to-parallel. Knowing about Parallel doesn’t necessarily mean knowing which API or config to use, and Supriya’s docs PR lets people install it straight from the API chooser page too. We can link to it from the cookbook once you’ve got skills set up there, so there’s only one copy to maintain.