Agent-Skills.md

Agent Skills: New Agent (Compatibility)

Create mdflow-backed agent files for Script Kit. Compatibility path — prefer creating skills (SKILL.md under a plugin's skills/ directory) for new reusable AI work.

UncategorizedID: johnlindquist/script-kit-next/new-agent

Repository

johnlindquist/script-kit-next
johnlindquistLicense: Apache-2.0
286

Install this agent skill to your local

pnpm dlx add-skill https://github.com/johnlindquist/script-kit-next/tree/HEAD/kit-init/skills/new-agent

Skill Files

Browse the full folder contents for new-agent.

Download Skill

Loading file tree…

kit-init/skills/new-agent/SKILL.md

Skill Metadata

Name
new-agent
Description
Create mdflow-backed agent files for Script Kit. Compatibility path — prefer creating skills (SKILL.md under a plugin's skills/ directory) for new reusable AI work.

New Agent (Compatibility)

Create mdflow-backed agent files for Script Kit. For new reusable AI work, prefer creating a skill (skills/<name>/SKILL.md) under the appropriate plugin instead — skills are first-class main-menu launchables that open Agent Chat.

Where Agents Live

~/.scriptkit/plugins/main/agents/*.md

Filename Rules

| Filename | Meaning | |----------|---------| | review.claude.md | Claude backend | | plan.agy.md | AGY backend | | code.codex.md | Codex backend | | triage.copilot.md | Copilot backend | | chat.i.agy.md | Interactive agent (.i. or _interactive: true) | | generic.md | Generic agent; use _command when needed |

Script Kit Metadata Keys

Use underscore-prefixed keys so Script Kit metadata does not leak to backend CLI flags.

  • _sk_name
  • _sk_description
  • _sk_icon
  • _sk_alias
  • _sk_shortcut

mdflow System Keys

  • _inputs
  • _interactive or _i
  • _cwd
  • _env
  • _command

Minimal Template

---
_sk_name: "Review PR"
_sk_description: "Review staged changes and call out risks"
_sk_icon: "git-pull-request"
model: sonnet
---

Review the current git diff.

Return:
1. findings ordered by severity
2. concrete fixes
3. tests to add

Interactive Template

---
_sk_name: "Plan Feature"
_sk_description: "Turn a feature request into an implementation plan"
_sk_icon: "map"
_interactive: true
_inputs:
  feature_name:
    type: text
    message: "Feature name?"
  risk_tolerance:
    type: select
    message: "Risk tolerance?"
    choices: ["low", "medium", "high"]
model: gemini-2.0-flash
---

Create an implementation plan for {{ feature_name }}.

Risk tolerance: {{ risk_tolerance }}.

Include:
- files to change
- data flow
- tests to add
- rollback plan

Common Mistakes

  • Do not put agent files in scripts/
  • Do not use export const metadata
  • Do not omit the backend suffix when you want a specific CLI
  • Do not use non-underscore sk_* keys

Related Skills

  • start-chat — programmatic Agent Chat workflows using the chat SDK
  • add-actions — expose script helpers through the Actions Menu
  • manage-notes — automate the Notes window from scripts
  • new-script — create and manage TypeScript scripts
  • new-scriptlet — package scripts as scriptlet bundles