article
Blog

Insights & Guides

Learn about AI agents, MCP servers, prompt engineering, and how to get the most out of your AI coding tools.

codeTutorialsstarsFeatured

Getting Started with Agent Shelf: Find, Download, and Use AI Agents

A step-by-step tutorial for using Agent Shelf to discover AI agents, download them into your coding tool, and start using them in under 5 minutes.

personAgent Shelf Teamcalendar_todayApr 8, 2026schedule4 min read
Read articlearrow_forward
Topicsmenu_bookGuidescodeTutorialstrending_upIndustry

All Posts

menu_bookGuides6 min

Agent Definition Frontmatter: Every Field Explained

A complete reference for YAML frontmatter in AI agent definitions. Covers every required and optional field, validation rules, and best practices with examples.

frontmatteryamlagent-design
Apr 10, 2026Readarrow_forward
codeTutorials12 min

Agent Definition Templates: 10 Starter Templates You Can Customize

Ready-to-use agent definition templates for code review, documentation, testing, security, and more. Copy, customize, and publish to Agent Shelf in minutes.

templatesagent-designgetting-started
Apr 10, 2026Readarrow_forward
menu_bookGuides4 min

AI Agents for Data Analysis and Visualization

Specialized AI agents turn your coding tool into a data analysis powerhouse. Learn how data analysis agents work, what they handle well, and how to choose the right one.

data-analysisvisualizationpandas
Apr 10, 2026Readarrow_forward
menu_bookGuides5 min

AI Agents for Security Auditing and Penetration Testing

Security-focused AI agents catch vulnerabilities that generic code review misses. Learn what makes a great security agent, common use cases, and how to choose one for your team.

securityauditingpenetration-testing
Apr 10, 2026Readarrow_forward
menu_bookGuides5 min

AI Agents for Technical Writing and Documentation

Documentation agents generate accurate, consistent docs by reading your actual source code. Learn what they handle well, where they fall short, and how to pick the right one.

writingdocumentationtechnical-writing
Apr 10, 2026Readarrow_forward
menu_bookGuides4 min

Best Agents for OpenAI Codex in 2026

OpenAI Codex supports agent skills for task-specific workflows. Learn how to find, install, and use AI agents with Codex CLI, IDE extensions, and the Codex app.

codexopenaiagents
Apr 10, 2026Readarrow_forward
menu_bookGuides5 min

Best Agents for GitHub Copilot in 2026

GitHub Copilot now supports agent skills and custom agents in VS Code. Learn how to find, install, and use AI agents with Copilot to go beyond autocomplete.

github-copilotagentsproductivity
Apr 10, 2026Readarrow_forward
menu_bookGuides6 min

Best Agents for Windsurf in 2026

Windsurf supports AI agents through the Agent Skills spec and AGENTS.md. Learn how to find, install, and use agents in Windsurf to get more from Cascade.

windsurfagentsproductivity
Apr 10, 2026Readarrow_forward
menu_bookGuides6 min

Claude Code vs Cursor vs Windsurf: Agent Support Compared

A practical comparison of how Claude Code, Cursor, and Windsurf handle AI agent definitions, skills, and MCP servers. Covers discovery, configuration, and portability.

claude-codecursorwindsurf
Apr 10, 2026Readarrow_forward
codeTutorials6 min

How to Build Your Own MCP Server (Step-by-Step)

A practical tutorial for building a custom MCP server from scratch using TypeScript. Covers tool registration, input validation, transport modes, and connecting to AI coding tools.

mcptutorialtypescript
Apr 10, 2026Readarrow_forward
menu_bookGuides6 min

How to Version Your AI Agents with SemVer

Semantic versioning for AI agents lets teams pin stable versions, track changes, and upgrade safely. Learn when to bump major, minor, and patch versions for agent definitions.

versioningsemverbest-practices
Apr 10, 2026Readarrow_forward
menu_bookGuides6 min

MCP vs Agent Skills: What's the Difference and When to Use Each

MCP and Agent Skills both extend AI coding tools, but they solve different problems. Learn what each does, how they compare, and when to use one over the other.

mcpagent-skillscomparison
Apr 10, 2026Readarrow_forward
codeTutorials6 min

How to Migrate from Copilot Instructions to Agent Skills

Step-by-step guide to converting your GitHub Copilot custom instructions into portable agent skills that work across Claude Code, Cursor, Windsurf, and 40+ AI tools.

github-copilotmigrationagent-skills
Apr 10, 2026Readarrow_forward
trending_upIndustry5 min

The Case for Portable Agent Definitions

Vendor lock-in for AI agents hurts everyone — authors, users, and the ecosystem. Here's why portable, plain-text agent definitions matter and how they change the game.

portabilityopen-standardsagent-skills
Apr 10, 2026Readarrow_forward
menu_bookGuides7 min

Writing Agent Definitions for Teams

How to standardize AI agent definitions across your team. Covers conventions, code review for agents, sharing, version management, and common organizational patterns.

teamscollaborationconventions
Apr 10, 2026Readarrow_forward
menu_bookGuides4 min

Best AI Agents for Code Review in 2026

AI code review agents catch bugs, flag security issues, and enforce style rules before code ships. Learn what makes a great code review agent and how to choose one for your team.

code-reviewcodingpull-requests
Apr 8, 2026Readarrow_forward
menu_bookGuides5 min

AI Agents for DevOps and CI/CD Automation

How specialized AI agents can help with CI/CD pipelines, Dockerfiles, Kubernetes configs, Terraform, and incident response. Practical use cases and what makes a good DevOps agent.

devopsci-cdautomation
Apr 8, 2026Readarrow_forward
menu_bookGuides5 min

AI Agents for SEO and Content Marketing

Specialized AI agents can handle keyword research, content briefs, on-page optimization, and content audits. Learn how marketing agents outperform generic prompts and what to look for when choosing one.

seocontent-marketingmarketing
Apr 8, 2026Readarrow_forward
menu_bookGuides4 min

Best Agents for Claude Code in 2026

Claude Code supports custom agents that transform it into a specialized coding assistant. Learn how to find, install, and get the most out of agents in Claude Code.

claude-codeagentsproductivity
Apr 8, 2026Readarrow_forward
menu_bookGuides4 min

Best Agents for Cursor AI in 2026

A practical guide to finding, installing, and using AI agents in Cursor. Covers agent discovery, recommended categories, and tips for getting the best results.

cursoragentsproductivity
Apr 8, 2026Readarrow_forward
trending_upIndustry5 min

How We Use AI Agents to Build Agent Shelf

A behind-the-scenes look at the specific AI agents the Agent Shelf team uses daily, what works well, and where human judgment still matters.

case-studybehind-the-scenesagent-shelf
Apr 8, 2026Readarrow_forward
codeTutorials5 min

How to Migrate from .cursorrules to Agent Skills

Step-by-step guide to converting your .cursorrules file into portable agent skills that work across Claude Code, Cursor, Windsurf, and other AI tools.

cursorcursorrulesagent-skills
Apr 8, 2026Readarrow_forward
codeTutorials4 min

How to Migrate from Custom GPTs to Agent Shelf

A step-by-step guide to converting your Custom GPTs into portable Agent Shelf definitions that work across Claude Code, Cursor, Windsurf, and 40+ AI tools.

migrationcustom-gptsopenai
Apr 8, 2026Readarrow_forward
menu_bookGuides5 min

5 Common Mistakes When Writing AI Agent Definitions

Avoid these five mistakes when writing AI agent definitions. Each includes a bad example and a fixed version so you can improve your agents immediately.

agent-designbest-practicesmistakes
Apr 8, 2026Readarrow_forward
menu_bookGuides2 min

What Are AI Agents and Why Should You Care?

AI agents are reusable instruction sets that give AI tools specialized skills. Learn what they are, how they work, and why they're changing how developers build software.

ai-agentsbeginnersoverview
Apr 1, 2026Readarrow_forward
codeTutorials2 min

Getting Started with MCP Servers: Connect Your AI Tools to the World

MCP servers give AI assistants real capabilities — database access, API calls, browser automation, and more. Here's how to set them up with Claude Code, Cursor, and other tools.

mcptutorialclaude-code
Mar 28, 2026Readarrow_forward
menu_bookGuides3 min

How to Write Effective Agent Definitions

A practical guide to writing AI agent definitions that produce consistent, high-quality results. Covers persona design, rule writing, workflow structuring, and common mistakes to avoid.

agent-designprompt-engineeringbest-practices
Mar 25, 2026Readarrow_forward
trending_upIndustry3 min

The Agent Skills Specification, Explained

Agent Skills is an open standard for portable AI tool capabilities. Learn how it works, which tools support it, and how to create skills that work across 40+ AI coding assistants.

agent-skillsopen-standardinteroperability
Mar 20, 2026Readarrow_forward
menu_bookGuides3 min

10 MCP Servers Every Developer Should Know About

A curated list of the most useful MCP servers for software development — from browser testing to database access to documentation lookup. Includes setup configs for each.

mcpdeveloper-toolsproductivity
Mar 15, 2026Readarrow_forward