# New Skill

> Scaffold a new skill under skills/<bucket>/<kebab-name>/. Creates SKILL.md with proper frontmatter, plus updates INVENTORY.md and skills/README.md in the same edit batch.

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

## Install

```sh
agentstack add skill-jajupmochi-agent-harness-new-skill
```

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

## About

# /new-skill

Scaffold a new skill following the Claude Code SKILL.md spec.

## Usage

```
/new-skill /
```

E.g.: `/new-skill general/find-duplicates` or `/new-skill research-pkg/new-experiment`

## Pre-flight

- Verify `skills///` does not already exist
- Verify `` is one of: `general/`, `research-pkg/`, `static-site/`, `productivity/`, `personal/` — or ask the user to add a new bucket if needed

> ⚠️ **Claude Code plugin discovery is TOP-LEVEL only.** CC auto-discovers `skills//SKILL.md` **one level
> deep** — it does NOT scan `skills///`. So a skill you want Claude to auto-discover MUST live at
> the top level `skills//` (like `memory-flywheel`, `tui-installer`, `figma-design-fetch`). The
> `skills/general/*` copies are reached by Codex (`skills/` glob) and opencode (deploy-skills), NOT by the CC
> plugin. If the skill should be Claude-discoverable, create it at `skills//` (bucket is then just
> an organizational tag in INVENTORY, not a path level).

## Steps

1. **Create directory**:

   ```bash
   mkdir -p skills//
   ```

2. **Ask the user** for:
   - One-line description (becomes `description:` frontmatter — this is what Claude reads to decide auto-invocation)
   - Trigger: `auto` (Claude invokes when matched) / slash-only (user must type `/`) / both
   - Skill body content — what does the skill do?

3. **Write `skills///SKILL.md`**:

   ```markdown
   ---
   name: 
   description: 
    disable-model-invocation: true
   ---

   # /

   

   ## Master TOC

   - [Pre-flight](#pre-flight)
   - [Steps](#steps)
   - [Notes for the agent](#notes-for-the-agent)
   - [Companion](#companion)

   ## Pre-flight

   

   ## Steps

   1. 
   2. 
   ...

   ## Notes for the agent

   

   ## Companion

   
   ```

4. **Update `skills/README.md`** — add a row to the skill index table.

5. **Update `INVENTORY.md` AND `INVENTORY.zh.md`** — add a row to the Skills section.

6. **Show the user** the diff and ask for confirmation before committing.

## Frontmatter conventions

- `name` — kebab-case, matches the directory name
- `description` — be specific about WHEN the skill fires. Claude uses this to decide auto-invocation. Vague descriptions cause both false positives and false negatives.
- `disable-model-invocation: true` — set for skills with side effects (deploy, force-push, etc.) that should only fire on explicit user request

## Companion

- `docs/CONTRIBUTING.md` §"Adding a skill" — formal spec
- `skills/README.md` — index of all skills + bucket conventions
- Anthropic's `skill-creator` plugin — for more sophisticated skill authoring with evals

## Source & license

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

- **Author:** [jajupmochi](https://github.com/jajupmochi)
- **Source:** [jajupmochi/agent-harness](https://github.com/jajupmochi/agent-harness)
- **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-jajupmochi-agent-harness-new-skill
- Seller: https://agentstack.voostack.com/s/jajupmochi
- 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%.