skills/parallel-web__parallel-agent-skills

mirror of https://github.com/parallel-web/parallel-agent-skills.git synced 2026-09-14 20:00:25 +08:00

Files

T

Matt Harris e2fa76ccd4 Add parallel-develop skill for bootstrapping integrations

Mirrors the /onboarding-guest landing-page experience as a user-invocable
skill: when a user says "integrate Parallel" / "add Parallel to my app",
the agent picks the matching API (Search / Task / FindAll / Monitor /
Extract) and client (Python / TypeScript / cURL / MCP), then emits install
+ env + a working code example with best-practice comments inline.

Structure (progressive disclosure per the Agent Skills spec):
- SKILL.md (71 lines): decision table, guardrails, and routing to a
  per-client recipe file.
- references/python.md: client.search, client.task_run (research +
  enrichment), client.beta.findall, client.extract, and an httpx
  fallback for the alpha Monitor API.
- references/typescript.md: same surface, with explicit guardrails that
  the TS SDK uses snake_case body fields (task_spec, output_schema,
  run_id) and a tsconfig note for the private-field lib-check issue.
- references/curl.md: raw HTTP equivalents with the correct endpoint
  versions (v1, v1beta, v1alpha).
- references/mcp.md: Claude Code / Cursor / VS Code / Claude Desktop
  configs for the hosted Search + Task MCP servers, including the
  macOS Claude Desktop gotchas (env inheritance, npx PATH, relaunch).

Complements, rather than replaces, the existing runtime skills
(parallel-web-search, parallel-deep-research, parallel-data-enrichment,
parallel-web-extract): those invoke parallel-cli to get work done now;
this one writes code the user will ship.

Bumps plugin + marketplace version to 0.3.0.

2026-04-21 14:13:16 -04:00

3.9 KiB

Raw Permalink Blame History

Parallel Agent Skills

Agent Skills for Parallel — web search, content extraction, deep research, and data enrichment for AI coding agents.

Prerequisites

Install the CLI

curl -fsSL https://parallel.ai/install.sh | bash

Get an API key at parallel.ai and set it as an environment variable:
```
export PARALLEL_API_KEY="your-key"
```
Or authenticate interactively after installing the CLI:
```
parallel-cli login
```
Install the skills into your AI agent (see below).

Installation

Agent Skills

Use the Vercel Skills CLI to install skills into Cursor, Cline, GitHub Copilot, and 30+ other agents.

# Install all skills globally (available in all projects)
npx skills add parallel-web/parallel-agent-skills --all --global

# Or install to current project only
npx skills add parallel-web/parallel-agent-skills --all

# Install a specific skill
npx skills add parallel-web/parallel-agent-skills --skill parallel-web-search

# Preview available skills
npx skills add parallel-web/parallel-agent-skills --list

Claude Code

Available as a Claude Code Plugin Marketplace.

/plugin marketplace add parallel-web/parallel-agent-skills
/plugin install parallel
# restart Claude Code before continuing!

# this will install the CLI and authenticate if not done already
/parallel:setup

OpenAI Codex

Install skills using the built-in skill installer (run inside Codex):

$skill-installer parallel-web/parallel-agent-skills

Then install the CLI and authenticate:

curl -fsSL https://parallel.ai/install.sh | bash
parallel-cli login

Skills

Skills follow the Agent Skills specification and double as Claude Code slash commands.

Skill	Description
parallel-web-search	Web search (default for most research queries)
parallel-web-extract	Extract content from URLs, articles, PDFs
parallel-deep-research	Comprehensive research and analysis
parallel-data-enrichment	Enrich lists of companies, people, products
parallel-develop	Bootstrap a Parallel API integration in your codebase (Python / TypeScript / cURL / MCP)
setup	Install CLI and authenticate
status	Check running research task status
result	Get completed research task result

Examples

/parallel:parallel-web-search latest React 19 features
/parallel:parallel-web-extract https://docs.parallel.ai
/parallel:parallel-deep-research competitive landscape of AI code assistants
/parallel:parallel-data-enrichment Apple, Microsoft, Google - get CEO names
/parallel:parallel-develop add a research agent to my Next.js app in typescript
/parallel:setup

Resources

Local Development

Claude Code:

git clone https://github.com/parallel-web/parallel-agent-skills.git
claude --plugin-dir /path/to/parallel-agent-skills
/parallel:setup

Codex:

git clone https://github.com/parallel-web/parallel-agent-skills.git
cd parallel-agent-skills
codex
# Skills are auto-discovered via .agents/skills/

Releasing a New Version

Claude Code plugins are pinned to commit SHAs, and npx skills add pulls the latest from main.

Bump the version in all three locations:
- .claude-plugin/plugin.json → version
- .claude-plugin/marketplace.json → metadata.version
- .claude-plugin/marketplace.json → plugins[0].version
Commit and push to main

License

MIT

3.9 KiB Raw Permalink Blame History