incomestreamsurfer/paperclip-surfers/agent-developer

Claude Code and agent skill by incomestreamsurfer/paperclip-surfers

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install incomestreamsurfer/paperclip-surfers/agent-developer

SKILL.md

The same SKILL.md was published earlier as incomestreamsurfer/paperclip-surfers/agent-developer.

Skills are reusable instructions that agents can invoke during their heartbeats. They're markdown files that teach agents how to perform specific tasks.

Skill Structure

A skill is a directory containing a SKILL.md file with YAML frontmatter:

skills/
└── my-skill/
├── SKILL.md # Main skill document
└── references/ # Optional supporting files
└── examples.md

SKILL.md Format

markdown
---
name: my-skill
description: >
Short description of what this skill does and when to use it.
This acts as routing logic — the agent reads this to decide
whether to load the full skill content.
---
# My Skill
Detailed instructions for the agent...
Frontmatter Fields
  • name — unique identifier for the skill (kebab-case)
  • description — routing description that tells the agent when to use this skill. Write it as decision logic, not marketing copy.

How Skills Work at Runtime

  1. Agent sees skill metadata (name + description) in its context
  2. Agent decides whether the skill is relevant to its current task
  3. If relevant, agent loads the full SKILL.md content
  4. Agent follows the instructions in the skill

This keeps the base prompt small — full skill content is only loaded on demand.

Best Practices

  • Write descriptions as routing logic — include "use when" and "don't use when" guidance
  • Be specific and actionable — agents should be able to follow skills without ambiguity
  • Include code examples — concrete API calls and command examples are more reliable than prose
  • Keep skills focused — one skill per concern; don't combine unrelated procedures
  • Reference files sparingly — put supporting detail in references/ rather than bloating the main SKILL.md

Skill Injection

Adapters are responsible for making skills discoverable to their agent runtime. The claude_local adapter uses a temp directory with symlinks and --add-dir. The codex_local adapter uses the global skills directory. See the Creating an Adapter guide for details.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
74
Repository forks
32
7-day trend score
22

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/incomestreamsurfer/paperclip-surfers/agent-developer/badge)](https://verified-skill.com/skills/incomestreamsurfer/paperclip-surfers/agent-developer)

Something wrong with this skill or its page? Tell us.