create-agent-template

Create Agent Template Skill

Generate Harness Agent Template files for AI-powered automation agents.

Instructions

1. Identify the agent's purpose - What task should the agent automate (code review, security scanning, test generation, documentation)?
2. Define inputs and configuration - What parameters does the agent need (repo, branch, connector, secrets)?
3. Generate three files - metadata.json (template metadata), pipeline.yaml (v1 syntax), and wiki.MD (user documentation)
4. Validate consistency - Ensure input references in pipeline.yaml match definitions in metadata.json

Overview

Agent templates are modular pipeline definitions that encapsulate AI-powered automation. Each template produces three files:

File	Required	Purpose
metadata.json	Yes	Template name, description, version
pipeline.yaml	Yes	Pipeline definition (v1 syntax)
wiki.MD	Recommended	User-facing documentation

Directory Structure

templates/<agent-name>/
  metadata.json
  pipeline.yaml
  wiki.MD

metadata.json

{
  "name": "Agent Name",
  "description": "Brief description of what this agent does (1-2 sentences)",
  "version": "1.0.0"
}

Rules:

• name: Sentence Case (Code Review, not code-review)
• description: Under 200 characters, clear value proposition
• version: Semantic versioning MAJOR.MINOR.PATCH

pipeline.yaml

Core Structure

version: 1
pipeline:
  clone:
    depth: 1
    ref:
      name: <+inputs.branch>
      type: branch
    repo: <+inputs.repo>
    connector: "<+inputs.gitConnector != null ? inputs.gitConnector.id : ''>"

  stages:
    - name: <stage-name>
      steps:
        - name: <step-name>
          run:
            container:
              image: <registry>/<image>:<tag>
            with:
              param: value
            env:
              SECRET_VAR: <+inputs.secretInput>
      platform:
        os: linux
        arch: arm64

  inputs:
    repo:
      type: string
      required: true
    branch:
      type: string
      default: main
    llmConnector:
      type: connector
    gitConnector:
      type: connector