Back to Spec Kit

EXAMPLE: Extension README

extensions/template/EXAMPLE-README.md

0.8.53.1 KB
Original Source

EXAMPLE: Extension README

This is an example of what your extension README should look like after customization. Delete this file and replace README.md with content similar to this.


My Extension

<!-- CUSTOMIZE: Replace with your extension description -->

Brief description of what your extension does and why it's useful.

Features

<!-- CUSTOMIZE: List key features -->
  • Feature 1: Description
  • Feature 2: Description
  • Feature 3: Description

Installation

bash
# Install from catalog
specify extension add my-extension

# Or install from local development directory
specify extension add --dev /path/to/my-extension

Configuration

  1. Create configuration file:

    bash
    cp .specify/extensions/my-extension/config-template.yml \
       .specify/extensions/my-extension/my-extension-config.yml
    
  2. Edit configuration:

    bash
    vim .specify/extensions/my-extension/my-extension-config.yml
    
  3. Set required values:

    <!-- CUSTOMIZE: List required configuration -->
    yaml
    connection:
      url: "https://api.example.com"
      api_key: "your-api-key"
    
    project:
      id: "your-project-id"
    

Usage

<!-- CUSTOMIZE: Add usage examples -->

Command: example

Description of what this command does.

bash
# In Claude Code
> /speckit.my-extension.example

Prerequisites:

  • Prerequisite 1
  • Prerequisite 2

Output:

  • What this command produces
  • Where results are saved

Configuration Reference

<!-- CUSTOMIZE: Document all configuration options -->

Connection Settings

SettingTypeRequiredDescription
connection.urlstringYesAPI endpoint URL
connection.api_keystringYesAPI authentication key

Project Settings

SettingTypeRequiredDescription
project.idstringYesProject identifier
project.workspacestringNoWorkspace or organization

Environment Variables

Override configuration with environment variables:

bash
# Override connection settings
export SPECKIT_MY_EXTENSION_CONNECTION_URL="https://custom-api.com"
export SPECKIT_MY_EXTENSION_CONNECTION_API_KEY="custom-key"

Examples

<!-- CUSTOMIZE: Add real-world examples -->

Example 1: Basic Workflow

bash
# Step 1: Create specification
> /speckit.spec

# Step 2: Generate tasks
> /speckit.tasks

# Step 3: Use extension
> /speckit.my-extension.example

Troubleshooting

<!-- CUSTOMIZE: Add common issues -->

Issue: Configuration not found

Solution: Create config from template (see Configuration section)

Issue: Command not available

Solutions:

  1. Check extension is installed: specify extension list
  2. Restart AI agent
  3. Reinstall extension

License

MIT License - see LICENSE file

Support

Changelog

See CHANGELOG.md for version history.


Extension Version: 1.0.0 Spec Kit: >=0.1.0