feat: add choose-your-parallel-api skill

[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: ***@***.***>