# Example Skill

> A minimal example skill that demonstrates the AG3NT SKILL.md format and contract.

- **Type:** Skill
- **Install:** `agentstack add skill-markdevshop-ag3nt-example-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [markdevshop](https://agentstack.voostack.com/s/markdevshop)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [markdevshop](https://github.com/markdevshop)
- **Source:** https://github.com/markdevshop/AG3NT/tree/main/skills/example-skill

## Install

```sh
agentstack add skill-markdevshop-ag3nt-example-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
./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](https://github.com/markdevshop)
- **Source:** [markdevshop/AG3NT](https://github.com/markdevshop/AG3NT)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-markdevshop-ag3nt-example-skill
- Seller: https://agentstack.voostack.com/s/markdevshop
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.