SuperAPI AI Directory

plugin-design

Design & creation

View repository

Updated 10-16 03:43

About this skill

Plugin Design

Quick Start

Design commands users will love:

# /create-plugin - Create new plugin

## What This Does
Creates a new plugin with guided setup.

## Usage

/create-plugin [name] [--type agent|command|skill]

Example

$ /create-plugin my-plugin --type agent
Creating... ✅
Next: /design-plugin my-plugin

## Command Design Principles

### Clear & Discoverable

✅ /create-plugin Clear action ✅ /design-plugin Obvious purpose ✅ /test-plugin Self-explanatory ✅ /optimize-plugin What it does


### Consistent Naming

Verb-noun pattern: ├─ /create-X ├─ /design-X ├─ /test-X └─ /optimize-X


## User Experience Patterns

### Interactive Workflow

User Input: /create-plugin

System Response:

  1. What's your plugin name?

    my-plugin

  2. Plugin type? [1] Agent-based [2] Command-based [3] Skill library

    1

  3. Number of agents?

    3

Output: ✅ Plugin created Next: /design-plugin


### Progressive Disclosure

Beginner: /create-plugin my-plugin (simple, guided)

Intermediate: /create-plugin my-plugin --type agent --agents 3 (more options)

Advanced: /create-plugin --config config.json --skip-validation (all options)


## Error Message Design

### User-Friendly Errors

❌ Bad: `Invalid input`
✅ Good: `Plugin name must be 3-50 characters, lowercase, hyphens only`

❌ Bad: `Error 500`
✅ Good: `Plugin creation failed: skill-one not found in agents/`

❌ Bad: `Fatal error`
✅ Good: `Missing required field 'description' in plugin.json`

## Interface Patterns

### Success Feedback

✅ Task completed ├─ What was done ├─ Where to find it └─ What's next


### Warnings

⚠️ Warning: Using old syntax ├─ Recommendation: Update to new syntax └─ Link: /help/migration-guide


### Errors

❌ Error: Manifest invalid ├─ Issue: Missing "author" field ├─ Fix: Add "author": "Your Name" └─ Help: /help/plugin-json


## Consistency Standards

### Visual Hierarchy

✅ Success (green) ⚠️ Warning (yellow) ❌ Error (red) ℹ️ Info (blue) → Action (arrow)


### Message Format

[Icon] [Brief message] ├─ [Detail 1] ├─ [Detail 2] └─ [Action or suggestion]


## Navigation Design

### Command Discovery

Help: ├─ /help Show all commands ├─ /help /create-plugin Help for specific command └─ /help --agents List all agents

Related: ├─ Run: /create-plugin ├─ Then: /design-plugin └─ Then: /test-plugin


### Intelligent Suggestions

After /create-plugin: → Suggestion: Run /design-plugin next (natural workflow progression)

After /test-plugin: → Suggestion: Run /optimize-plugin (next logical step)


## Accessibility Design

### Clear Language

✅ Simple words ✅ Short sentences ✅ Active voice ✅ No jargon

❌ "Facilitate optimization" ✅ "Make faster"


### Visual Clarity

✅ Good contrast ✅ Large text ✅ Clear structure ✅ Readable font


### Keyboard Navigation

✅ All commands accessible via keyboard ✅ No mouse required ✅ Clear keyboard shortcuts


## Feedback Mechanisms

### Immediate Feedback

User types: /create System shows: Available commands starting with 'create' ├─ /create-plugin ├─ /create-agent └─ /create-skill


### Progress Indication

Creating plugin... ⠋ Creating folders ✅ Folders created ⠙ Writing files ✅ Files written ⠹ Validating structure ✅ Validation complete ✅ Done!


### Confirmation

Are you sure you want to delete my-plugin? (This cannot be undone)

[Yes, delete] [No, cancel]


## Workflow Patterns

### Simple Linear

/create → /design → /test → /deploy


### Branching

/test ├─ Tests pass → /deploy └─ Tests fail → Fix issues → /test again


### Exploratory

/explore-agents ├─ Agent details └─ Related agents


## Help System

### Context-Sensitive Help

After error: ❌ Skill name invalid 💡 Need help? ├─ Show format examples ├─ Visit docs └─ Ask @plugin-developer


### Progressive Complexity

Level 1: What does this command do? Level 2: How do I use it? Level 3: What options are available? Level 4: Advanced use cases?


## User Feedback Integration

### Suggestions

Users often ask about: ├─ "How do I structure my plugin?" → /design-plugin command └─ "How do I test it?" → /test-plugin command


### Common Issues

We notice users struggle with: ├─ JSON formatting → Add JSON validation └─ Naming conventions → Add clear examples


---

**Use this skill when:**
- Designing commands
- Planning workflows
- Creating help systems
- Improving user experience
- Designing error messages

---

**Status**: ✅ Production Ready | **SASMP**: v1.3.0 | **Bonded Agent**: 03-plugin-designer