Promptbase

PromptBase Skill Publishing

Patterns for writing Claude Code skills that pass PromptBase review and sell well.

When to Activate

• Writing a new skill intended for sale on PromptBase
• Reviewing an existing skill before submission
• Adapting a rejected skill after a "too specific" or "too simple" ruling
• Writing listing copy — title, description, examples, setup instructions
• Deciding whether a skill idea is worth submitting at all

The Core Test: Would a Stranger Pay For This?

Before writing a single line, answer three questions:

If any answer is red, fix the concept before writing the skill.

Rejection Reasons and Fixes

Too Specific (most common rejection)

What it means: The skill only works for users of a niche platform, private SDK, or internal framework. The audience is too small to justify listing it.

Signs your skill is too specific:

• It imports from a private package (from mycompany.lib import ...)
• It references internal tool names, ports, config files, or env vars no outsider would know
• It combines more than 3 niche ideas (e.g. "LangGraph + Agentex + custom state machine")
• The target framework has fewer than ~5k GitHub stars

Fix: generalize the layer

REJECTED:  Temporal + Agentex ADK + adk.state + adk.messages + FastACP
APPROVED:  Temporal + Python temporalio SDK — standard patterns any developer can use

Strip the platform-specific layer. Keep the hard, transferable patterns underneath.

Too Simple / Guessable

What it means: A buyer could recreate the skill by reading the title and thinking for 30 seconds. The value isn't there.

Signs your skill is too simple:

• The entire skill is one pattern or one code snippet
• It documents official defaults (e.g. "how to create a FastAPI route")
• It has no decision tables, no red flags, no non-obvious gotchas
• Word count is low AND there are no patterns that require explanation

Fix: add depth

• Add a decision table (when to use X vs Y)
• Add a Red Flags section (7–10 anti-patterns with explanations)
• Add the non-obvious gotchas — things that only experience teaches
• Add a pre-ship checklist

No Use Case

What it means: The skill has no practical application for real work — it's a demo, experiment, or overly academic topic.

Fix: Anchor every section to a real scenario a working developer would face. If you can't name a concrete task the skill helps complete, the concept needs rethinking.

Scope Rules

The 3-niche rule: PromptBase rejects skills that combine more than 3 niche ideas. A "niche idea" is any tool, pattern, or concept that a developer might not already know. Standard Python, SQL, and REST are not niche. LangGraph, Temporal, and a custom state machine pattern together are three niche ideas — borderline.

Writing the Listing

Title

# BAD — platform-specific, tiny audience
Agentex Temporal Agent Skill

# BAD — too vague, no value signal
Python Async Skill

# GOOD — specific problem, broad audience
Crash-Proof AI Agents: Temporal Workflow Skill for Claude Code

Formula: [Outcome the buyer wants]: [Technology] Skill for Claude Code

Description (keep it under 100 words)

Structure:

1. One sentence on the problem it solves
2. 4–6 bullet points on what Claude knows after activation
3. One line on format and installation

Your Temporal workflows break in ways that are invisible until production.
This skill teaches Claude the patterns that prevent it.

- Workflow vs activity split and determinism rules
- Retry policies, timeouts, and heartbeats
- State management across replays
- Signal handling and `wait_condition`
- 7 red flags that silently break Temporal agents

One `.md` file. Drop in `~/.claude/skills/` — activates automatically.

When to Use (activation description)

Write this as a single sentence starting with "Use when" that describes triggering conditions — not a summary of topics:

# BAD — topic summary, not a trigger
Use when working with Temporal, workflows, activities, signals, and state.

# GOOD — triggering condition
Use when building or debugging Temporal workflows in Python — structuring
activities, enforcing determinism, handling retries, or diagnosing replay failures.

Examples (2 required)

Each example is a realistic user message + a sample Claude response showing the skill in action.

Example 1 (shown as preview on store page): Pick the sharpest, most impressive demo — the problem that would make a buyer think "I need this right now."

Example 2: Show a different use case from Example 1. Don't demonstrate the same pattern twice.

# BAD example pair — same pattern twice
Example 1: "How do I add a retry to my activity?"
Example 2: "How do I set a timeout on my activity?"

# GOOD example pair — different concerns
Example 1: "My workflow stops receiving signals after the first message."
Example 2: "Can I call httpx directly inside my workflow?"