agency-setup

Bootstrap or refresh srid/agency integration in a codebase using uvx.

25|2|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/srid/agency --skill agency-setup-srid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agency-setup
Source: https://github.com/srid/agency/tree/main/.apm/skills/agency-setup
Command: npx skills add https://github.com/srid/agency --skill agency-setup-srid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap or update srid/agency in this project to enable a repeatable, idempotent setup workflow that can be run by developers to bootstrap or refresh an install.

Core Features & Use Cases

  • Idempotent bootstrap and refresh: detects existing configuration and only makes needed changes to apm.yml, host folders, and workflow instructions.
  • Automated integration to apm: installs or refreshes the srid/agency dependency, regenerates runtime folders (.claude/, .opencode/, .codex/), and prepares AGENTS.md as needed.
  • Workflow drafting: produces or updates the required workflow instructions so teams can reproduce the setup end-to-end.

Quick Start

Run the agency-setup skill to bootstrap or refresh srid/agency in this repository using uvx to invoke apm and generate the necessary workspace files.

Frequently Asked Questions about agency-setup

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

FAQPage Schema
How do I bootstrap srid/agency in an existing codebase?

To bootstrap srid/agency in an existing codebase, run the agency-setup skill using uvx to invoke apm, which detects existing configurations and generates the necessary apm.yml, host folders, and workflow instruction drafts in a single pass.

Can I refresh an existing apm.yml configuration without losing workflow instructions?

Yes, you can refresh an existing apm.yml configuration without losing workflow instructions because the agency-setup skill runs an idempotent process that detects existing files and only applies the needed incremental upgrades.

Do I need uvx to run the apm setup workflow?

Yes, you need uvx or an equivalent tool to run apm during the agency setup workflow, as it is required to invoke the package manager and regenerate the necessary workspace files.

What runtime folders does the agency bootstrap process regenerate?

The agency bootstrap process regenerates the .claude/, .opencode/, and .codex/ runtime folders, while also preparing the AGENTS.md file to ensure the development environment is fully synchronized.

Why does my idempotent devops setup keep overwriting host folders?

An idempotent devops setup overwrites host folders when the agency-setup skill detects outdated configurations, intentionally regenerating runtime folders and workflow drafts to ensure the workspace matches the latest srid/agency integration.