Skip to content

Commit dd7d451

Browse files
committed
docs(skills): remove model names, point agents at the API
Strip specific model names from the find-models, prompt-images, and prompt-videos skills so agents don't anchor on names from training data or past conversations. Add directives at the top of each skill telling agents to query the Replicate API for current best models. Build and publish skills are unchanged because their model references point at real production cog repos used as build patterns, not running model recommendations.
1 parent 4e85074 commit dd7d451

3 files changed

Lines changed: 25 additions & 7 deletions

File tree

skills/find-models/SKILL.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@ name: find-models
33
description: Find AI models on Replicate using search and curated collections.
44
---
55

6+
## Always search the API for current models
7+
8+
The AI model landscape changes weekly. New models ship constantly and older ones are deprecated or surpassed. Don't rely on model names you've seen before, including names from past conversations or training data. A specific model you "know" may no longer be the best choice, may be slower than newer alternatives, or may not exist anymore.
9+
10+
Always start by querying the Replicate API. Use search and collections to discover what's currently available, then read schemas to understand inputs and outputs before running anything.
11+
612
## Docs
713

814
- Reference: <https://replicate.com/docs/llms.txt>
@@ -42,6 +48,6 @@ description: Find AI models on Replicate using search and curated collections.
4248

4349
## Model identifiers
4450

45-
- **Official models** use `owner/name` format (e.g. `black-forest-labs/flux-2-klein-9b`). Routes to the latest version automatically.
51+
- **Official models** use `owner/name` format (e.g. `owner/model-name`). Routes to the latest version automatically.
4652
- **Community models** require `owner/name:version_id`. You must pin a specific version. Community models can cold-boot and take time to start.
4753
- If you must use a community model, be aware that it can take a long time to boot. You can create always-on deployments, but you pay for model uptime.

skills/prompt-images/SKILL.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,13 @@ description: >
77

88
# Prompting image models on Replicate
99

10-
Distilled from Replicate's blog posts on prompting image models (2024-2026). Techniques are model-agnostic and focus on transferable principles. For model selection, pricing, and feature comparison, see the [compare-models](../compare-models/SKILL.md) skill.
10+
Distilled from Replicate's blog posts on prompting image models (2024-2026). Techniques are model-agnostic and focus on transferable principles.
11+
12+
## Choose a model with the API, not from memory
13+
14+
This skill describes general prompting techniques. To choose a model, use the [find-models](../find-models/SKILL.md) skill and query the Replicate API. The image model landscape changes weekly. Don't assume specific models exist or are still state-of-the-art based on names you've seen before. Always search the API for current options, then read the schema before running anything.
15+
16+
For pricing and feature comparison, see the [compare-models](../compare-models/SKILL.md) skill.
1117

1218

1319
## Writing prompts
@@ -180,9 +186,9 @@ Some models can generate multiple related images in a single prompt.
180186
10. **Not iterating**: The best results come from iterative workflows. Make a small change, evaluate, refine, repeat. Don't try to get everything right in a single generation.
181187

182188

183-
## Sources
189+
## Background reading
184190

185-
All techniques in this skill are sourced from Replicate's blog:
191+
The techniques above are distilled from Replicate's blog posts on prompting image models. The posts are anchored to specific models that were current at the time, but the techniques generalize across modern image models. Use these for additional context, then use the [find-models](../find-models/SKILL.md) skill to pick a model that fits your task today.
186192

187193
- [How to prompt Seedream 5.0](https://replicate.com/blog/how-to-prompt-seedream-5) (Feb 2026)
188194
- [Recraft V4](https://replicate.com/blog/recraft-v4) (Feb 2026)

skills/prompt-videos/SKILL.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,13 @@ description: >
88

99
# Prompting video models on Replicate
1010

11-
Distilled from Replicate's blog posts on prompting video models (2025-2026). Techniques are model-agnostic and focus on transferable principles. For model selection, pricing, and feature comparison, see the [compare-models](../compare-models/SKILL.md) skill.
11+
Distilled from Replicate's blog posts on prompting video models (2025-2026). Techniques are model-agnostic and focus on transferable principles.
12+
13+
## Choose a model with the API, not from memory
14+
15+
This skill describes general prompting techniques. To choose a model, use the [find-models](../find-models/SKILL.md) skill and query the Replicate API. The video model landscape changes weekly. Don't assume specific models exist or are still state-of-the-art based on names you've seen before. Always search the API for current options, then read the schema before running anything.
16+
17+
For pricing and feature comparison, see the [compare-models](../compare-models/SKILL.md) skill.
1218

1319

1420
## Scene description
@@ -322,9 +328,9 @@ If the model supports subject reference images, use a clear photo of the charact
322328
10. **Forgetting that video models don't have internet access**: No video model has live information. They work from training data. Don't expect them to know about current events or real-time information.
323329

324330

325-
## Sources
331+
## Background reading
326332

327-
All techniques in this skill are sourced from Replicate's blog:
333+
The techniques above are distilled from Replicate's blog posts on prompting video models. The posts are anchored to specific models that were current at the time, but the techniques generalize across modern video models. Use these for additional context, then use the [find-models](../find-models/SKILL.md) skill to pick a model that fits your task today.
328334

329335
- [How to make remarkable videos with Seedance 2.0](https://replicate.com/blog/seedance-2) (Apr 2026)
330336
- [How to prompt Veo 3.1](https://replicate.com/blog/veo-3-1) (Oct 2025)

0 commit comments

Comments
 (0)