# Skill Author

> Authoring skills for skillet. Covers the skill format, discovery via suggest, and project manifests.

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

## Install

```sh
agentstack add skill-joshrotenberg-skillet-skill-author
```

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

## About

## Skill Authoring Guide

### Skill Format

A skill is a directory with a required `SKILL.md` file:

```
owner/skill-name/
  SKILL.md         # the skill prompt with YAML frontmatter (required)
  scripts/         # optional executable scripts
  references/      # optional reference docs
  assets/          # optional templates, configs
```

### SKILL.md

Agent Skills spec-compatible markdown with YAML frontmatter for metadata:

```markdown
---
name: my-skill
description: What this skill does and when to use it.
version: 2026.02.27
trigger: When to activate this skill
license: MIT
author: Your Name
categories:
  - development
tags:
  - rust
  - testing
---

## My Skill

Instructions for the agent...
```

**Frontmatter fields**: `name`, `description`, `version`, `trigger`,
`license`, `author`, `categories`, `tags`. All optional -- skillet infers
what it can from the directory name, git remote, and content.

**Zero-config mode**: a directory with only a bare `SKILL.md` (no
frontmatter) is still discoverable. Frontmatter improves search results.

### Extra Files

- `scripts/` -- executable scripts the skill references
- `references/` -- reference documentation for context
- `assets/` -- templates, configs, or other static files

### Scaffolding

```bash
skillet init-skill owner/skill-name
skillet init-skill owner/skill-name --description "My skill" --category development --tags "rust,testing"
```

### Discovery via Suggest

Use `[[suggest]]` in your repo's `skillet.toml` to create a decentralized
discovery graph. Each suggest entry points to another repo that skillet
can traverse to find more skills:

```toml
[[suggest]]
url = "https://github.com/org/their-skills.git"
description = "Skills from org"
```

This lets users discover skills across repos without a central authority.

### Project Manifest

Embed skills in any repository with `skillet.toml`:

```bash
skillet init-project path --skill     # single inline skill
skillet init-project path --multi     # multi-skill directory
skillet init-project path --registry  # repo configuration
```

```toml
[project]
name = "my-tool"
description = "A CLI tool"

# Single inline skill (SKILL.md at project root)
[skill]
name = "my-tool-usage"
description = "How to use my-tool"

# Or multiple skills in a subdirectory
[skills]
path = ".skillet"
members = ["api", "debug"]
```

## Source & license

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

- **Author:** [joshrotenberg](https://github.com/joshrotenberg)
- **Source:** [joshrotenberg/skillet](https://github.com/joshrotenberg/skillet)
- **License:** Apache-2.0

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-joshrotenberg-skillet-skill-author
- Seller: https://agentstack.voostack.com/s/joshrotenberg
- 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%.