Commit Graph

34 Commits

Author SHA1 Message Date
patrikbraborec f0720a1a79 Clarify apify run usage and replace templates with CLI commands
- Add explicit warnings about using `apify run` instead of npm/npx commands
- Replace template markdown files with CLI commands in Template Selection
- Add to Do/Don't sections: use `apify run`, not `npm start` or `npx apify run`
- Remove actor-template-js.md, actor-template-python.md, actor-template-ts.md

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-22 13:15:24 +01:00
Dušan Vystrčil 6360760436 Merge pull request #6 from apify/actor-development-skill
Actor development skill
2026-01-21 18:26:05 +01:00
patrikbraborec c5f9628e05 Fix validation to skip commands-only plugins
Updated marketplace.json validation to skip plugins that don't have
a "skills" property (e.g., commands-only plugins). This fixes the CI
error where apify-actor-commands plugin was incorrectly flagged for
missing SKILL.md.

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-21 15:19:41 +01:00
patrikbraborec e4323da0f0 Update generatedBy instructions to include tool and model
Changed instructions to specify both the tool name and model name in the generatedBy property (e.g., "Claude Code with Claude Sonnet 4.5") instead of just the model name. This helps Apify better monitor and improve documentation for specific AI tools and models.

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-21 15:16:00 +01:00
patrikbraborec 7fd6354325 Rename actor-development command to create-actor and register as plugin
- Rename commands/actor-development.md to commands/create-actor.md
- Add apify-actor-commands plugin entry in marketplace.json
- Register /create-actor as available command in Claude Code

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 18:00:43 +01:00
patrikbraborec 33b3fa761b Move actor-development command to top-level commands directory
Reorganize actor-development.md from skills/apify-actor-development/commands/ to top-level commands/ directory. Update all relative paths to reference files, changing from relative paths to repository-root-relative paths (skills/apify-actor-development/references/).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 17:35:52 +01:00
patrikbraborec b276afeea2 Add guided actor development command workflow
Adds a systematic 10-phase workflow command for developing Apify Actors,
covering discovery, environment setup, language selection, architecture
design, implementation, testing, and deployment with best practices.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-16 17:19:24 +01:00
patrikbraborec 1dbc05cc74 Rename actor-development skill to apify-actor-development
Add apify- prefix to distinguish from potential third-party skills with similar names.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 16:44:14 +01:00
patrikbraborec ff56b41572 Move actor-development from plugins to skills directory
Restructure actor-development from plugins/actor-development to skills/actor-development to align with the repository structure. Update marketplace.json, README.md, and AGENTS.md to reflect the new location.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 16:41:17 +01:00
patrikbraborec 2e092f4deb Add Agent Skills for Actor Development 2026-01-14 16:40:14 +01:00
patrikbraborec 04d9ae9e8b Add Actor Development skill 2026-01-14 16:40:14 +01:00
Dušan Vystrčil 321567d66a Merge pull request #5 from apify/dev
chore: add apify- prefix to skill names for branding
2026-01-14 16:15:49 +01:00
Dusan Vystrcil 49079ca3c9 chore: add apify- prefix to skill names for branding
Rename lead-generation to apify-lead-generation so users can
distinguish Apify marketplace skills from their own custom commands.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 16:14:58 +01:00
Dušan Vystrčil 4fcc62bce0 Merge pull request #4 from apify/dev
feat: auto-update USER_AGENT version when bumping skill versions
2026-01-14 15:49:45 +01:00
Dusan Vystrcil 1da6bafe67 feat: auto-update USER_AGENT version when bumping skill versions
The generate_agents.py script now updates USER_AGENT in run_actor.py
when bumping skill versions, keeping tracking versions in sync.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 15:48:13 +01:00
Dušan Vystrčil 60c01e8ab4 Merge pull request #3 from apify/dev
feat: add User-Agent tracking and update README
2026-01-14 15:43:34 +01:00
Dusan Vystrcil b20a2549c7 feat: add User-Agent tracking and update README output formats
- Add User-Agent header to API calls for usage analytics tracking
- Track start_actor, download_csv, download_json, and quick_answer calls
- Remove redundant Supported Apify Actors table from README
- Update Output Format section to document all supported formats

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 15:42:20 +01:00
Dušan Vystrčil 3a482b2eda Merge pull request #2 from apify/dev
feat: reorganize repository to flat skills structure
2026-01-14 15:15:23 +01:00
Dusan Vystrcil b176803efa chore: remove hooks from repo (personal dev only)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 15:05:50 +01:00
Dusan Vystrcil 20a7640e80 chore: rename skill from generating-leads to lead-generation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 14:51:32 +01:00
Dusan Vystrcil cae58117ad feat: reorganize repository to flat skills structure
- Move skills directly to skills/ folder (from plugins/*/skills/)
- Add multi-tool support (Codex, Gemini CLI, Cursor) via agents/AGENTS.md
- Add generate_agents.py script with auto-generation and version bumping
- Add GitHub Actions workflow for CI validation
- Add Claude Code hook for auto-regeneration on commit
- Update README with new repo URL (github.com/apify/agent-skills)
- Add gemini-extension.json for Gemini CLI compatibility

BREAKING CHANGE: Repository structure changed from plugins/ to skills/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-14 14:32:36 +01:00
Dušan Vystrčil 1324dfb8fa Merge pull request #1 from apify/dev
Bump versions and add installation verification
2026-01-08 18:33:49 +01:00
Dusan Vystrcil ef95a2f491 Bump versions and add installation verification
- Update marketplace version to 1.0.3
- Bump lead-generation plugin to 2.0.15
- Add /skills verification instructions to README

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 18:29:58 +01:00
Dusan Vystrcil ca592920a3 Streamline workflows documentation to focus on advanced multi-step examples
- Keep only 2 advanced workflows (B2B Lead List, YouTube Creator Lead Generation)
- Remove 7 redundant basic workflow examples already documented in Actor reference files
- Remove Common Follow-up Actions section
- Fix Actor IDs to use correct authors (streamers/youtube-scraper)
- Bump plugin version to 2.0.14

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 17:37:49 +01:00
Dusan Vystrcil 3d5fbfb56b Add essential fields and quick answer output format
- Define essential fields for all 18 Actors in generating-leads skill
- Add Quick answer output mode: displays top 5 results in chat with link to full dataset
- Add --fields parameter to run_actor.py (all/basic) for data completeness control
- Make --output parameter optional to enable chat display mode
- Support nested field extraction using dot notation (e.g., authorMeta.name)
- Update SKILL.md with new output format options and examples
- Bump version to 2.0.13

Allows users to get concise results directly in chat without creating files, with option to export basic fields or complete data to CSV/JSON as needed.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 17:17:44 +01:00
Dusan Vystrcil 9744b77e75 Update documentation and standardize configuration
- Update repository URL to https://github.com/apify/claude-code-plugins
- Bump marketplace version 1.0.1 → 1.0.2 and plugin version 2.0.11 → 2.0.12
- Expand supported Actors table from 6 to 18 actors with platform grouping
- Standardize actor ID format to forward slash (author/actor) throughout
- Standardize capitalization of "Actor" as Apify product name
- Update marketplace.json name to "apify" and improve descriptions
- Add comprehensive keywords and platform details

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 12:25:13 +01:00
Dusan Vystrcil b49abf5d42 Add cost transparency and workflow documentation to actor guides
- Add Pricing Breakdown sections to Google Maps and Google Search scrapers
  showing base costs, optional add-ons, and premium features with 🚨 warnings
- Add Common Use Cases (7 per actor) with practical examples and cost estimates
  ranging from free tier to premium features ($100-$200 per 1,000 results)
- Add Cost Management Guidelines for AI with clear prompts for when to ask
  users about paid features and how to estimate costs
- Include AI workflow instructions for each use case with confirmation patterns
- Provide cost control strategies and cheaper alternatives for premium features
- Bump plugin version to 2.0.11

Prevents surprise costs by defaulting to free tier and requiring explicit
user confirmation before enabling paid features. Critical for expensive
add-ons like business leads enrichment ($100/1,000) and AI modes ($200/1,000).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-08 11:24:07 +01:00
Dusan Vystrcil 7704a51f68 Add Instagram and TikTok actor schemas and bump version to 2.0.10
Added comprehensive actor documentation for:
- Instagram: search, posts/comments, tagged posts scrapers
- TikTok: main scraper, free scraper, user search, followers scrapers
- Facebook: events and page contact information scrapers

Updated SKILL.md with new actor references and README with local business discovery use case. Bumped plugin version from 2.0.9 to 2.0.10.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-08 10:42:06 +01:00
Dusan Vystrcil 1cbb554589 Standardize actor ID format to tilde notation and add auto-conversion
- Update actor IDs from slash (author/actor) to tilde (author~actor) format in examples
- Add automatic conversion in run_actor.py to handle both formats transparently
- Bump plugin version to 2.0.9

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 10:04:15 +01:00
Dusan Vystrcil 788f75a56b Consolidate actor documentation and add schema reading step
- Merge duplicate "Determine Lead Source" and "Actor Reference Documentation" sections into a single table
- Add explicit Step 2 for reading actor schema from reference docs
- Include direct links to schema files in lead source table
- Update workflow step numbering accordingly
- Bump plugin version to 2.0.7

This reduces token waste from duplication and clarifies the workflow.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 09:47:25 +01:00
Dusan Vystrcil 2596ed88f5 Restructure actor reference documentation into individual files
Split the monolithic actors.md (1100+ lines) into 9 focused actor reference files in reference/actors/ directory, each named with full author/actor ID for clarity:
- compass-crawler-google-places.md
- vdrmota-contact-info-scraper.md
- apify-instagram-profile-scraper.md
- clockworks-tiktok-profile-scraper.md
- apify-facebook-pages-scraper.md
- apify-facebook-groups-scraper.md
- apify-google-search-scraper.md
- streamers-youtube-scraper.md
- poidata-google-maps-email-extractor.md

Updated SKILL.md to include indexed reference documentation with direct links to each actor file. Fixed actor ID format from tilde (~) to forward slash (/) notation throughout. Corrected google-maps-email-extractor author from apify to poidata.

This improves maintainability, navigation, and prevents naming conflicts between actors from different developers.
2026-01-08 09:37:54 +01:00
Dusan Vystrcil 10812cc8f2 Add four new use case examples to lead-generation plugin README
Expand the Real-World Examples section with TikTok, YouTube, partnership development, and CRM enrichment examples. This provides better coverage of the supported platforms and demonstrates additional lead generation scenarios.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 14:22:34 +01:00
Dusan Vystrcil c3f17dc622 Restructure lead-generation plugin to follow best practices
- Reorganize skill structure: create reference/ subfolder for actors.md, workflows.md, and scripts/
- Rename skill from lead-finder to generating-leads following naming conventions
- Remove deprecated slash commands (find-businesses, enrich-contacts, prospect-groups, scrape-profiles)
- Rewrite README.md with human-friendly content and real-world examples from usecases.csv:
  * Local business prospecting (coffee bean wholesaler)
  * Software company lead generation (executive coach)
  * Influencer discovery (travel brand)
  * Contact enrichment (marketing team)
  * Social media prospecting (eco-friendly brand)
- Update plugin metadata: version 1.0.3 → 2.0.1, expand keywords with platform names
- Update all internal path references in SKILL.md and workflows.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 14:12:29 +01:00
Dusan Vystrcil 39b0eeac3c Init setup 2026-01-07 13:28:52 +01:00