# Gentle Ai Skill Creator

> Trigger: /skill-creation, skill creation, skill creator, create skill, new skill. Create LLM-first skills with valid frontmatter.

- **Type:** Skill
- **Install:** `agentstack add skill-gentleman-programming-gentle-pi-skill-creator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Gentleman-Programming](https://agentstack.voostack.com/s/gentleman-programming)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Gentleman-Programming](https://github.com/Gentleman-Programming)
- **Source:** https://github.com/Gentleman-Programming/gentle-pi/tree/main/skills/skill-creator
- **Website:** https://gentle-ai.gentlemanprogramming.com/

## Install

```sh
agentstack add skill-gentleman-programming-gentle-pi-skill-creator
```

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

## About

## Activation Contract

Use this skill when creating or updating a reusable AI skill for Pi or another agent runtime.

Create a skill when:
- a workflow or convention is reused across sessions;
- generic agent behavior needs project-specific constraints;
- a decision tree helps the agent choose safely;
- examples, templates, or references would make future execution more reliable.

Do not create a skill for a one-off task, generic documentation, or rules that belong in code/tests.

## Hard Rules

- Follow `docs/skill-style-guide.md` as the normative source for skill structure and style.
- A skill is an LLM runtime contract, not human-facing docs.
- Keep `SKILL.md` concise: target 180–450 tokens, max 1000.
- Use imperative instructions and concrete gates; avoid tutorials and background prose.
- Frontmatter `description` must be one physical YAML-safe line and include trigger words first.
- Do not add a `Keywords` section; put essential trigger words in `description`.
- Put templates, schemas, and generated examples in `assets/`.
- Put longer rationale or local doc links in `references/`.
- After changing project skills, refresh the registry with `/skill-registry:refresh` when available.

## Decision Gates

| Need | Action |
| --- | --- |
| Small reusable behavior | Create `skills/{skill-name}/SKILL.md` only |
| Templates, schemas, fixtures | Add `skills/{skill-name}/assets/` |
| Longer explanation or edge cases | Add `skills/{skill-name}/references/` |
| Existing skill covers it | Update the existing skill instead |
| Skill affects delegation discovery | Ensure trigger words appear in `description` |

## Execution Steps

1. Read `docs/skill-style-guide.md` before creating or updating skills.
2. Inspect existing skills and confirm the new skill does not duplicate one.
3. Choose a kebab-case skill name that matches the user-facing trigger.
4. Create or update this structure:

```text
skills/{skill-name}/
├── SKILL.md
├── assets/       # optional
└── references/   # optional
```

5. Use this frontmatter shape:

```yaml
---
name: {skill-name}
description: "Trigger: {phrases users or agents will say}. {What this skill does}."
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"
---
```

6. Write sections in this order: Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, References.
7. If this is a packaged `gentle-pi` skill, add it to `scripts/verify-package-files.mjs`.
8. Refresh or document the skill registry update path.

## Output Contract

Return:
- Files created or modified.
- Whether this created a new skill or updated an existing one.
- Any supporting `assets/` or `references/` files added.
- Whether package verification or skill registry refresh is needed.

## References

- `docs/skill-style-guide.md` — normative LLM-first skill style guide.
- `skills/skill-registry/SKILL.md` — registry refresh and indexing contract.

## Source & license

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

- **Author:** [Gentleman-Programming](https://github.com/Gentleman-Programming)
- **Source:** [Gentleman-Programming/gentle-pi](https://github.com/Gentleman-Programming/gentle-pi)
- **License:** MIT
- **Homepage:** https://gentle-ai.gentlemanprogramming.com/

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-gentleman-programming-gentle-pi-skill-creator
- Seller: https://agentstack.voostack.com/s/gentleman-programming
- 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%.