update-agent

Scan agent template directories and create, update, or delete agents.

2|1|Updated May 3, 2025
One-click install
npx skills add https://github.com/specklesystems/speckle-docs-NEW --skill update-agent-specklesystems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-agent
Source: https://github.com/specklesystems/speckle-docs-NEW/tree/main/.universal-ai-config/skills/update-agent
Command: npx skills add https://github.com/specklesystems/speckle-docs-NEW --skill update-agent-specklesystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool streamlines the lifecycle of agent templates by automatically locating existing agents, deciding whether to create or modify, and writing the updated template to the designated path.

Core Features & Use Cases

  • Locate existing agent templates by scanning a template directory.
  • Decide between creating, updating, or deleting agents based on changes to requirements.
  • Write or modify agent frontmatter and body (system prompt) to reflect new capabilities and permissions.
  • Use cases include adding a new specialized agent, updating a clause or tool set, or deprecating an old agent.

Quick Start

Create a new Markdown file in the agent templates directory with a descriptive name and frontmatter including name and description, then provide the agent system prompt in the body.

Frequently Asked Questions about update-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and update AI agent templates automatically?

To create and update AI agent templates automatically, use a tool that scans your designated template directory, decides whether to create or modify files, and writes the system prompt body with YAML frontmatter enforcing name and description fields.

What is YAML frontmatter and why do agent templates need it?

YAML frontmatter is metadata at the top of a Markdown file that enforces required fields like name and description for agent templates. It defines the agent's identity and capabilities before the system prompt body is written.

How do I add a new specialized agent to an existing templates directory?

To add a new specialized agent, create a Markdown file in the agent templates directory with a descriptive name, include YAML frontmatter with name and description, then provide the agent system prompt in the body.

Can I delete or deprecate old agents from my template directory?

Yes, you can delete or deprecate old agents from your template directory. The update process handles deletion scenarios for deprecated agents, modifying the template directory to reflect current requirements and removing obsolete files.

Does updating an agent template modify the system prompt body?

Yes, updating an agent template modifies the system prompt body. The template body is written as the system prompt, and changes to requirements trigger modifications to both the YAML frontmatter and the body content.

What's the best way to manage agent lifecycle changes across a template directory?

The best way to manage agent lifecycle changes across a template directory is automating the process of locating existing agents, deciding whether to create, update, or delete them, and persisting changes to the correct template path.