template-ops

Estrelas0

Forks0

Atualizado9 de março de 2026 às 05:19

Apply, teardown, and validate declarative YAML templates for agents and workflows. Use when working with .agentd/ template files, deploying agent+workflow stacks, or debugging template application issues.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

geoffjay

geoffjay/agentd

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

SKILL.md

readonly

name	template-ops
description	Apply, teardown, and validate declarative YAML templates for agents and workflows. Use when working with .agentd/ template files, deploying agent+workflow stacks, or debugging template application issues.

Template Operations

Operational skill for working with agentd declarative YAML templates.

Template Directory Structure

.agentd/
├── agents/
│   ├── worker.yml        # Agent definitions
│   ├── reviewer.yml
│   └── planner.yml
├── workflows/
│   ├── issue-worker.yml  # Workflow definitions referencing agents by name
│   └── pull-request-reviewer.yml
└── templates/
    └── *.yml             # Reusable prompt/config templates

Applying Templates

# Apply entire directory (agents first, then workflows)
agent apply .agentd/

# Apply a single agent
agent apply .agentd/agents/worker.yml

# Apply a single workflow (agent must already exist)
agent apply .agentd/workflows/issue-worker.yml

# Dry run — validate without creating
agent apply .agentd/ --dry-run

# Custom timeout for agent startup
agent apply .agentd/ --wait-timeout 120

Application Order

Agent templates are created first
System waits for each agent to reach Running status (default 60s timeout)
Workflow templates are created, referencing agents by name
Workflows are automatically enabled on creation

Tearing Down Templates

# Teardown entire directory (workflows first, then agents)
agent teardown .agentd/

# Teardown a single resource
agent teardown .agentd/agents/worker.yml

Teardown Order (reverse of apply)

Workflows are deleted first
Then agents are deleted (stops tmux sessions)

Agent Template Format

# .agentd/agents/worker.yml
name: worker                    # Unique name (used by workflow references)
working_dir: "."                # Working directory (. = project root)
shell: /bin/zsh                 # Shell for tmux session
worktree: false                 # Use git worktree isolation
model: claude-sonnet-4-6        # Model (or alias: sonnet, opus, haiku)

system_prompt: |
  You are a worker agent for the project.
  ...instructions...

Required fields: name, working_dir, model Optional fields: shell, worktree, system_prompt, env (map of env vars)

Workflow Template Format

# .agentd/workflows/issue-worker.yml
name: issue-worker
agent: worker                   # References agent by name (not ID)

source:
  type: github_issues           # or github_pull_requests
  owner: geoffjay
  repo: agentd
  labels:
    - agent                     # Filter by labels
  state: open                   # Filter by state

poll_interval: 60               # Seconds between polls
enabled: true

prompt_template: |
  Work on issue #{{source_id}}: {{title}}
  URL: {{url}}
  Labels: {{labels}}
  {{body}}

Required fields: name, agent, source, prompt_template Optional fields: poll_interval (default 60), enabled (default true), tool_policy

Troubleshooting

Apply times out waiting for agent

Increase timeout: agent apply .agentd/ --wait-timeout 120
Check orchestrator logs for agent startup errors
Verify tmux is available: tmux -V
Check if agent was partially created: agent orchestrator list-agents

Workflow references unknown agent

The agent name in agent: field must match a running agent's name
If applying a directory, agents are created first — this should work automatically
If applying a single workflow file, ensure the agent exists and is Running

Template validation errors

Use --dry-run to check templates before applying
Verify YAML syntax with a linter
Check that all required fields are present
Ensure model names are valid (sonnet, opus, haiku, or full model IDs)

Teardown doesn't clean up everything

Teardown only removes resources defined in the template files
Manually check: agent orchestrator list-agents and agent orchestrator list-workflows
Tmux sessions should be killed when agents are deleted

Examples

The project includes example templates:

# Apply the full agentd project example
agent apply examples/agentd-project/

# Check what it created
agent orchestrator list-agents
agent orchestrator list-workflows

# Tear it down
agent teardown examples/agentd-project/

Mais deste repositório

mesmo repositório

agent-memory

geoffjay/agentd

Store, search, and manage shared knowledge through the memory service. Use for persisting information across agent sessions, semantic search over stored knowledge, and inter-agent knowledge sharing.

2026-06-170

agent-knowledge

geoffjay/agentd

Browse, read, and author per-project knowledgebase documents through the knowledge service CLI. Use for creating, updating, listing, and reading markdown documents stored against a project, and reconciling DB rows against disk.

2026-06-170

release

geoffjay/agentd

Cut a new agentd release. Suggests the next semver version from conventional commits (or accepts an explicit `x.y.z`), bumps the workspace version, regenerates the changelog with git-cliff, then commits, tags, and pushes the `v*` tag that triggers the Release workflow. Use when the user runs /release or asks to publish/cut/tag a new version.

2026-06-070

create-plan-issue

geoffjay/agentd

Create a new GitHub plan issue with the "Plan: <title>" format, appropriate labels, and structured body. Use when the user wants to capture a high-level plan for future work.

2026-05-120

agent-ask

geoffjay/agentd

Ask the human user a question during workflow execution and check for answers. Use for agent-to-human Q&A, collecting decisions, and reacting to human responses via ask_response workflow triggers.

2026-04-040

git-spice

geoffjay/agentd

Branch stacking and PR management with git-spice for the agentd project. Use when creating stacked branches, submitting PRs, syncing with upstream, resolving rebase conflicts, or navigating a branch stack.

2026-03-220

name	template-ops
description	Apply, teardown, and validate declarative YAML templates for agents and workflows. Use when working with .agentd/ template files, deploying agent+workflow stacks, or debugging template application issues.

Template Operations

Operational skill for working with agentd declarative YAML templates.

Template Directory Structure

.agentd/
├── agents/
│   ├── worker.yml        # Agent definitions
│   ├── reviewer.yml
│   └── planner.yml
├── workflows/
│   ├── issue-worker.yml  # Workflow definitions referencing agents by name
│   └── pull-request-reviewer.yml
└── templates/
    └── *.yml             # Reusable prompt/config templates

Applying Templates

# Apply entire directory (agents first, then workflows)
agent apply .agentd/

# Apply a single agent
agent apply .agentd/agents/worker.yml

# Apply a single workflow (agent must already exist)
agent apply .agentd/workflows/issue-worker.yml

# Dry run — validate without creating
agent apply .agentd/ --dry-run

# Custom timeout for agent startup
agent apply .agentd/ --wait-timeout 120

Application Order

Agent templates are created first
System waits for each agent to reach Running status (default 60s timeout)
Workflow templates are created, referencing agents by name
Workflows are automatically enabled on creation

Tearing Down Templates

# Teardown entire directory (workflows first, then agents)
agent teardown .agentd/

# Teardown a single resource
agent teardown .agentd/agents/worker.yml

Teardown Order (reverse of apply)

Workflows are deleted first
Then agents are deleted (stops tmux sessions)

Agent Template Format

# .agentd/agents/worker.yml
name: worker                    # Unique name (used by workflow references)
working_dir: "."                # Working directory (. = project root)
shell: /bin/zsh                 # Shell for tmux session
worktree: false                 # Use git worktree isolation
model: claude-sonnet-4-6        # Model (or alias: sonnet, opus, haiku)

system_prompt: |
  You are a worker agent for the project.
  ...instructions...

Required fields: name, working_dir, model Optional fields: shell, worktree, system_prompt, env (map of env vars)

Workflow Template Format

# .agentd/workflows/issue-worker.yml
name: issue-worker
agent: worker                   # References agent by name (not ID)

source:
  type: github_issues           # or github_pull_requests
  owner: geoffjay
  repo: agentd
  labels:
    - agent                     # Filter by labels
  state: open                   # Filter by state

poll_interval: 60               # Seconds between polls
enabled: true

prompt_template: |
  Work on issue #{{source_id}}: {{title}}
  URL: {{url}}
  Labels: {{labels}}
  {{body}}

Required fields: name, agent, source, prompt_template Optional fields: poll_interval (default 60), enabled (default true), tool_policy

Troubleshooting

Apply times out waiting for agent

Increase timeout: agent apply .agentd/ --wait-timeout 120
Check orchestrator logs for agent startup errors
Verify tmux is available: tmux -V
Check if agent was partially created: agent orchestrator list-agents

Workflow references unknown agent

The agent name in agent: field must match a running agent's name
If applying a directory, agents are created first — this should work automatically
If applying a single workflow file, ensure the agent exists and is Running

Template validation errors

Use --dry-run to check templates before applying
Verify YAML syntax with a linter
Check that all required fields are present
Ensure model names are valid (sonnet, opus, haiku, or full model IDs)

Teardown doesn't clean up everything

Teardown only removes resources defined in the template files
Manually check: agent orchestrator list-agents and agent orchestrator list-workflows
Tmux sessions should be killed when agents are deleted

Examples

The project includes example templates:

# Apply the full agentd project example
agent apply examples/agentd-project/

# Check what it created
agent orchestrator list-agents
agent orchestrator list-workflows

# Tear it down
agent teardown examples/agentd-project/