# Convergent Skills

> Cross-ecosystem reference for agent skills as a portable capability format.

Convergent Skills explains how reusable agent skills package instructions, optional scripts, references, and assets so AI agents can reuse domain capability across Claude, Codex, GitHub Copilot, MCP development workflows, and other skills-compatible systems.

## Core Pages

- [Home](https://convergentskills-com.pages.dev/) - Thesis, map, and source-backed anchors.
- [Free tools](https://convergentskills-com.pages.dev/tools) - Browser-only utilities for skill authoring and architecture decisions.
- [Skill Scaffold Generator](https://convergentskills-com.pages.dev/tools/skill-generator) - Generate a SKILL.md scaffold and portable plain-Markdown variant.
- [Skill vs MCP Decider](https://convergentskills-com.pages.dev/tools/skill-or-mcp) - Decide whether a capability belongs in a skill, an MCP server, or both.
- [Skill Description Linter](https://convergentskills-com.pages.dev/tools/description-linter) - Score a skill description for trigger quality and suggested fixes.
- [Skills vs tools vs MCP](https://convergentskills-com.pages.dev/skills-vs-tools-vs-mcp) - Taxonomy of prompts, skills, tools, MCP servers, resources, and prompts.
- [Anatomy of a skill](https://convergentskills-com.pages.dev/anatomy-of-a-skill) - SKILL.md, frontmatter, scripts, references, assets, and progressive disclosure.
- [Authoring reusable skills](https://convergentskills-com.pages.dev/authoring) - How to scope, write, test, and distribute a skill.
- [Claude skill template](https://convergentskills-com.pages.dev/claude-skill-template) - Copyable SKILL.md template with required frontmatter and portability notes.
- [Skill description best practices](https://convergentskills-com.pages.dev/skill-description-best-practices) - How to write trigger descriptions that activate at the right time.
- [How portable are skills?](https://convergentskills-com.pages.dev/portability) - Honest limits of cross-client portability.
- [Skill patterns and examples](https://convergentskills-com.pages.dev/examples) - Practical patterns for document work, brand voice, code review, release readiness, MCP development, and data analysis.
- [Glossary](https://convergentskills-com.pages.dev/glossary) - Definitions for Agent Skills, SKILL.md, progressive disclosure, MCP, tools, resources, prompts, and portability.
- [Sources](https://convergentskills-com.pages.dev/sources) - Annotated bibliography.
- [FAQ](https://convergentskills-com.pages.dev/faq) - Short answers to common questions.

## Primary Source Families

- Agent Skills: https://agentskills.io/home and https://agentskills.io/specification
- Claude Agent Skills: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
- OpenAI Codex Skills: https://developers.openai.com/codex/skills
- VS Code Agent Skills: https://code.visualstudio.com/docs/agent-customization/agent-skills
- Model Context Protocol: https://modelcontextprotocol.io/docs/getting-started/intro and https://modelcontextprotocol.io/specification/2025-11-25

## Related

- Free tool index: https://convergentskills-com.pages.dev/tools
- Claude-specific skills directory: https://claudehasskills-com.pages.dev
- Full machine-readable guide: https://convergentskills-com.pages.dev/llms-full.txt