Skill Creator

What it does

When your agent uses it

• Tasks that involve Skill authoring

Example prompts

• “Use the skill-creator skill to create new skills from templates via guided workflow. An agent skill from softspark/ai-toolkit”
• “/skill-creator”

Requirements

• Python 3
• Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Grep, Glob

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Capture intent -- ask: what should the skill do? Who invokes it?
2. 2Classify -- task, hybrid, or knowledge? (see Classification Guide below)
3. 3Interview -- gather: framework, tools, scope, output format, constraints
4. 4Write SKILL.md -- frontmatter + body, under 500 lines
5. 5Create supporting files -- reference/, templates/, scripts/ as needed
6. 6Test and iterate -- invoke, observe, refine

What it can do on your machine

Read from SKILL.md and the folder at commit d64db2b. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Write
  • Edit
  • Bash
  • Grep
  • Glob

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships script files (Python), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • code.claude.com
  • agentskills.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Creator loads about 2.4k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 1,004 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~34

When it runs · the whole SKILL.md, loaded when a task matches

~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Write, Edit, Bash, Grep, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from softspark/ai-toolkit at commit d64db2b, republished under its Apache-2.0 licence (© softspark). 1,004 words, ~2,381 tokens.

name

skill-creator

description

Creates new skills from templates via guided workflow. Triggers: new skill, create skill, skill scaffold, skill template.

allowed-tools

Read, Write, Edit, Bash, Grep, Glob

effort

high

disable-model-invocation

true

argument-hint

[skill name or description]

skill-name/
  SKILL.md              # Main instructions (required, <500 lines)
  reference/            # Detailed docs (loaded on-demand)
  templates/            # Reusable templates for output
  scripts/              # Executable helper scripts

---
name: {name}
description: "{Third-person description, min 50 chars, with trigger hint like 'Use when...'}"
argument-hint: "[hint]"
allowed-tools: Read, Grep, Glob
---

# {Title}

$ARGUMENTS

{One-line purpose statement.}

## Usage

\`\`\`
/{name} [arguments]
\`\`\`

## What This Command Does

1. **Step one**
2. **Step two**
3. **Step three**

## Example

\`\`\`
/{name} example-argument
\`\`\`

{Expected observable behavior.}

## Rules

- **MUST** {non-negotiable rule 1}
- **NEVER** {forbidden action}
- **CRITICAL**: {safety constraint}

## Gotchas

- {environment-specific trap the agent would miss — concrete, not general}
- {non-obvious behavior of a tool, API, or data layout}

## When NOT to Use

- For {adjacent use case} -- use `/{other-skill}` instead
- For {another case} -- use `/{another-skill}`
- If {precondition} is not met

© softspark, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in app/skills/skill-creator of softspark/ai-toolkit.

• SKILL.md
• templates/dashboard/index.html
• templates/reasoning-engine/assets/example.json
• templates/reasoning-engine/search.py

Open the folder on GitHubat commit d64db2b