skill-creator

Skill Creator

Use this skill when creating or maintaining a memmy-agent skill.

Core Principles

Keep the skill small enough to load quickly. Put only the essential workflow in SKILL.md; move detailed reference material into references/, reusable deterministic code into scripts/, and output assets into assets/.

Write for another agent that is already capable. Include the procedural details, constraints, commands, schemas, and examples that would be annoying or risky to rediscover.

Skill Shape

A skill is a directory with one required file and optional resources:

skill-name/
├── SKILL.md
├── scripts/
├── references/
└── assets/

SKILL.md must contain YAML frontmatter followed by Markdown instructions.

Required frontmatter:

---
name: my-skill
description: Do the specific workflow. Use when the agent needs to handle concrete trigger cases.
---

Supported memmy-agent frontmatter fields:

• name: lowercase letters, digits, and hyphens only.
• description: the trigger text that decides when the skill is useful.
• metadata: optional memmy-agent runtime metadata.
• always: optional boolean for skills that should always load.
• license: optional license label.
• allowed-tools: optional tool guidance for consumers.

Use only metadata.memmy for runtime metadata:

metadata:
  memmy:
    always: true
    manualOnly: false
    requires:
      bins: ["gh"]
      env: ["GITHUB_TOKEN"]

Set metadata.memmy.manualOnly: true for a Skill that must stay out of the normal Skill index and load only when the current task explicitly references $skill-name. Do not combine it with startup initialization.

Creation Workflow

1. Clarify the real use cases and triggering phrases.
2. Pick a short hyphen-case name.
3. Create <workspace>/skills/<skill-name>/SKILL.md.
4. Add only the resource directories that are actually needed.
5. Run the validator.
6. Test any scripts by executing them on realistic inputs.

Create files directly. There is no required init scaffold command for memmy-agent skills.