Skip to content

docs: split monolithic skill into five focused skills#6

Merged
zeke merged 3 commits into
mainfrom
zeke/split-into-four-skills
Apr 21, 2026
Merged

docs: split monolithic skill into five focused skills#6
zeke merged 3 commits into
mainfrom
zeke/split-into-four-skills

Conversation

@zeke
Copy link
Copy Markdown
Member

@zeke zeke commented Apr 17, 2026

This PR replaces the single skills/replicate/ skill with five focused skills:

  • find-models (47 lines) -- search API, collections, schemas, model selection guidance
  • compare-models (44 lines) -- evaluating models by cost, speed, quality, capabilities
  • run-models (69 lines) -- predictions, polling, webhooks, streaming, file I/O, concurrency, multi-model workflows
  • prompt-images (~180 lines) -- prompting techniques for image generation and editing models
  • prompt-videos (~280 lines) -- prompting techniques for video generation models

The three API skills (find, compare, run) follow the same concise bullet-point style as the original skill: no code snippets, no SDK references, just focused guidance with pointers to docs, the OpenAPI schema, and the MCP server.

The two prompting skills are new content distilled from Replicate's blog posts. They are model-agnostic by design: techniques are organized by principle (scene description, camera language, audio prompting, text rendering, style transfer, etc.) rather than by model name, so they age well as models come and go. The compare-models skill handles model selection.

Other changes

  • script/lint auto-discovers and validates all skill directories
  • .claude-plugin/marketplace.json updated to list all five skills
  • .claude-plugin/plugin.json bumped to version 2.0.0
  • .github/workflows/ci.yml publishes five skills to ClawHub
  • AGENTS.md updated with all five skills
  • compare-models cross-references both prompting skills

Breaking change

Existing installations that used npx skills add replicate/skills have a lockfile pointing to skills/replicate/SKILL.md. After this merge, npx skills update will fail for those users. They'll need to remove and re-add:

npx skills remove replicate
npx skills add replicate/skills

z added 2 commits April 17, 2026 07:47
Replaces the single skills/replicate/ skill with four:

- find-models: search API, collections, schemas, model selection guidance
- compare-models: evaluating models by cost, speed, quality, capabilities
- run-models: predictions, polling, webhooks, streaming, file I/O, concurrency, multi-model workflows
- prompt-images: prompting techniques for image generation and editing models (sourced from 14 Replicate blog posts)

The find-models and run-models skills include runnable code snippets in bash, Python, and JavaScript pulled from the comprehensive skill branch. The prompt-images skill is new content distilled from Replicate's blog.

Also updates script/lint to validate all skills by default.
Remove all code snippets and SDK references from find-models, compare-models,
and run-models to match the concise bullet-point style of the original skill.

Update .claude-plugin/marketplace.json to list all four skills.
Update .claude-plugin/plugin.json version to 2.0.0.
Update CI to publish four skills to ClawHub with replicate- prefixed slugs.
@zeke zeke changed the title docs: split monolithic replicate skill into four focused skills docs: split monolithic skill into five focused skills Apr 17, 2026
@zeke
Copy link
Copy Markdown
Member Author

zeke commented Apr 21, 2026

@replicate/dev looking for eyes on this please!

Copy link
Copy Markdown
Member

@michaeldwan michaeldwan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't worked on a skill library like this yet, so take my feedback with a grain of salt. But this is fantastic.

@zeke zeke merged commit 5a33a7f into main Apr 21, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants