This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

REPLACE: Skill Title

REPLACE: One-line summary of what this skill helps the agent accomplish.

Workflow

REPLACE: Understand the user's goal, pick the right Actor(s).
REPLACE: Fetch the Actor's input schema, build a valid input.
REPLACE: Run the Actor, confirm with user if estimated cost is significant.
REPLACE: Deliver results (count, format, link to dataset/console).

For a worked 4-step workflow, see apify/agent-skills ultimate-scraper.

Actor routing

User need	Actor ID	Tier	Best for
REPLACE	`apify/REPLACE-actor`	apify	REPLACE
REPLACE	`community/REPLACE-actor`	community	REPLACE

Tier = apify (Apify-maintained, prefer) or community (third-party).

Calling Actors — choose your interface

Skills in this repo can call Actors via any of these interfaces. Pick the one that fits your runtime; cross-tool compatibility is your responsibility.

Option A: Apify CLI (recommended for portability)

Works in any shell-capable agent. Three flags on every call:

apify actors call "ACTOR_ID" -i 'JSON_INPUT' \
  --json \
  --user-agent apify-awesome-skills/REPLACE-skill-name \
  2>/dev/null

Flag	Why
`--json`	Stable machine-readable output
`--user-agent`	Apify telemetry attribution
`2>/dev/null`	Suppress progress messages that break JSON

Other useful commands:

# Search Actors
apify actors search "KEYWORDS" --json --limit 10 2>/dev/null

# Fetch Actor schema
apify actors info "ACTOR_ID" --input --json \
  --user-agent apify-awesome-skills/REPLACE-skill-name 2>/dev/null

# Fetch results
apify datasets get-items DATASET_ID --format json \
  --user-agent apify-awesome-skills/REPLACE-skill-name 2>/dev/null

For the canonical command set with all flags, see apify/agent-skills ultimate-scraper.

Option B: Apify MCP connector

Hosted MCP server at https://mcp.apify.com. Documented at https://docs.apify.com/platform/integrations/mcp.

Option C: MCP client of your choice (e.g. `mcpc`)

Standalone CLI client. See https://github.com/apify/mcpc.

Copy & paste — that's it

npx skills add https://github.com/apify/awesome-skills --skill _template

Run this in your project — your agent picks the skill up automatically.

Prerequisites

Apify account (sign up)
Authentication via one of:
- apify login (OAuth, if using the Apify CLI)
- APIFY_TOKEN environment variable
- Token from Apify Console → Settings → Integrations

Troubleshooting

REPLACE: common error 1 → fix
REPLACE: common error 2 → fix
For detailed cost guardrails and recovery, see references/gotchas.md.

Licensed under Apache-2.0— you can use, modify, and redistribute it under that license's terms.

View the full license file on GitHub →