@sentiosurge/agent-creator

Scaffold AI agent definition files from a name and natural language prompt. Compatible with Claude Code, OpenClaw, and the open AGENTS.md standard.

Install

npm install -g @sentiosurge/agent-creator

Usage

# Short prompt — inline
agent-creator -n "news-briefer" -p "Daily morning tech news briefing via Telegram"

# Long prompt — from file
agent-creator -n "news-briefer" --prompt-file ./my-idea.txt

# Long prompt — piped via stdin
cat my-idea.txt | agent-creator -n "news-briefer"

# Custom output directory
agent-creator -n "news-briefer" -p "..." -o ./my-agents

# Split format (SOUL.md + IDENTITY.md + AGENTS.md)
agent-creator -n "news-briefer" -p "..." -f split

Options

| Flag | Short | Description | Default | |------|-------|-------------|---------| | --name <name> | -n | Agent name (slug or display name) | required | | --prompt <text> | -p | Short inline prompt | — | | --prompt-file <path> | | Read prompt from a file | — | | --output-dir <dir> | -o | Parent directory for agent folders | ./agents | | --format <fmt> | -f | unified or split | unified | | --help | -h | Show help | — |

Output Formats

Unified (default)

Creates a single agent.md with YAML frontmatter + Markdown body:

agents/news-briefer/
  agent.md

---
name: news-briefer
display_name: "News Briefer"
description: "AI agent: News Briefer"
emoji: "🤖"
model: gpt-5-mini
skills: []
---

# Soul

## Role
...

## Personality
...

## Principles
...

## Boundaries
...

# Instructions
...

Split (OpenClaw-compatible)

Creates three separate files:

agents/news-briefer/
  SOUL.md        # Personality, principles, boundaries
  IDENTITY.md    # Name, emoji, vibe
  AGENTS.md      # Operational instructions, model, skills

JSON Output

The CLI outputs structured JSON for programmatic use:

{
  "status": "ok",
  "agent_name": "news-briefer",
  "display_name": "News Briefer",
  "format": "unified",
  "directory": "/path/to/agents/news-briefer",
  "files": ["/path/to/agents/news-briefer/agent.md"],
  "prompt": "Daily morning tech news briefing via Telegram",
  "next_step": "Edit agent.md to fill in soul, skills, and instructions."
}

As a Skill

This package also works as a skill for AI coding assistants. The SKILL.md file provides a 5-step workflow for AI agents to decompose natural language descriptions into complete agent definitions:

1. Understand the request
2. Decompose into identity, soul, capabilities, operations
3. Scaffold directory structure
4. Generate file contents
5. Review with user

Cross-Platform Compatibility

| Platform | How to use | |----------|-----------| | Claude Code | Copy frontmatter fields to .claude/agents/name.md | | OpenClaw | Use --format split for SOUL.md + IDENTITY.md + AGENTS.md | | Generic | Frontmatter is valid YAML; body is standard Markdown |

License

MIT