Example Skill

Example Skill

This skill demonstrates the AG3NT skill contract. Use it when the user asks about how skills work or wants to see an example.

When to Use

• User asks "how do skills work?"
• User wants to understand the SKILL.md format
• User asks for an example skill

Skill Contract

Every AG3NT skill follows this structure:

skill-name/              # Folder name = canonical skill ID
├── SKILL.md             # Required: YAML frontmatter + markdown instructions
├── scripts/             # Optional: executable scripts
│   └── run.sh           # Entrypoint scripts referenced in frontmatter
└── references/          # Optional: supporting docs, configs, examples
    └── notes.md

YAML Frontmatter Fields

Required:

• name: Must match folder name (max 64 chars, lowercase alphanumeric + hyphens)
• description: What the skill does (max 1024 chars)

Optional (Agent Skills spec):

• license: License name (e.g., "MIT", "Apache-2.0")
• compatibility: Environment requirements
• metadata: Arbitrary key-value map
• allowed-tools: Space-delimited list of pre-approved tools

AG3NT Extensions:

• version: Semantic version (e.g., "1.0.0")
• tags: Array of categorization tags
• triggers: Keywords/phrases that activate this skill
• entrypoints: Named scripts with descriptions
• required_permissions: Permissions needed for approval flow

Running the Example Script

This skill includes an example entrypoint. To run it:

./scripts/run.sh

The script will print a confirmation message.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: markdevshop
• Source: markdevshop/AG3NT
• License: MIT

Install and usage instructions live in the source repository linked above.