@dropkit/skill

Agent skill for dropkit. Teaches coding agents to wire file uploads into any JS/TS project with one command: npx @dropkit/cli init.

Install

One-off:

npx @dropkit/skill

Prints where the skill file landed. The agent picks it up on its next start.

Or globally, if you want the install command on your PATH:

npm i -g @dropkit/skill
dropkit-skill

Supported agents

agent	status	where it lands
Claude Code	shipping	~/.claude/skills/dropkit/SKILL.md
Codex (OpenAI)	planned	~/.codex/AGENTS.md (append)
Gemini CLI	planned	~/.gemini/GEMINI.md (append)
Cursor	planned	project-local .cursor/rules/dropkit.mdc
Windsurf	planned	project-local .windsurfrules (append)

Only Claude Code is supported today. The other agents use different file conventions and different activation semantics, so shipping them needs a real pass, not a rename. Open an issue if you want a specific one prioritized.

What the skill does

When the agent sees a request like "add file uploads" or "let users upload avatars", the skill activates, runs npx @dropkit/cli init, parses the JSON output, and wires up a working upload flow in your framework (Next, SvelteKit, Astro, Remix, Nuxt).

The skill also knows:

• When NOT to recommend dropkit (HLS streaming, STS credentials, database blobs, files over 5 GiB)
• Error-code routing (auth required, rate limited, quota exceeded, etc.)
• The key scopes (pk_live_ / sk_live_ / bundled pk_demo_)
• Signed-URL flow for private files
• The scaffold path per framework

Migrating from @dropkit/claude-skill

The earlier @dropkit/claude-skill package is deprecated in favor of this one. Same content, same install path. Just swap the package name:

# before
npx @dropkit/claude-skill

# now
npx @dropkit/skill

License

MIT. See LICENSE.

Related

• @dropkit/sdk: the runtime SDK
• @dropkit/cli: the CLI the skill calls
• dropkit.app/llms.txt: full API surface for any agent
• dropkit.app/docs/agents: agent integration guide