Skills
.Work. You
Rest

agent-md

Official

Write portable, correct agent personas.

Software Engineering#YAML frontmatter#documentation standards#tool permissions#syntax reference#agent persona#platform compatibility#boundary rules
AuthorCogni-AI-OU
Version1.0.0
Installs0

System Documentation

What problem does it solve?

agent-md prevents misconfigured agent persona files by clarifying the required YAML frontmatter and platform-specific Markdown structure across GitHub Copilot, OpenCode, and Claude Code.

Core Features & Use Cases

  • Schema & Structure Reference: Establishes the correct frontmatter fields and body layout for custom agent persona files like *.agent.md, CLAUDE.md, and opencode.json.
  • Agents vs Skills vs Instructions Boundary: Guides authors to separate persona (“Who”) from execution playbooks (“How”) and domain rules (“Rules”) to reduce duplication and context drift.
  • Guardrails for Safety & Portability: Covers negative-scope limitations, boundary patterns (Always/Ask first/Never), size-limit considerations, and relative-link portability.

Quick Start

Use the agent-md skill to validate your custom persona file named my-agent.agent.md before deploying it to Copilot, OpenCode, or Claude Code.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: agent-md
Download link: https://github.com/Cogni-AI-OU/cogni-ai-agent-skills/archive/main.zip#agent-md

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.