agent

Inspect and apply repository-local agent profiles from .volon/agents YAML files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hollis-labs/volon --skill agent-hollis-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent
Source: https://github.com/hollis-labs/volon/tree/main/plugins/core/skills/agent
Command: npx skills add https://github.com/hollis-labs/volon --skill agent-hollis-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill makes it simple and safe to switch the current AI session to a repository-local agent persona by inspecting and applying an agent profile without modifying repository files or global state.

Core Features & Use Cases

  • Normalizes and validates a provided profile name to a slug and ensures the corresponding .volon/agents/<slug>.yaml file exists.
  • Displays the raw profile YAML and prints a concise summary including name, description, boot_prompt, PCC includes, write scope, tool allowlist, suggested workflows, and envelopes.
  • Provides clear error handling and a list of available profiles when a slug is invalid, and documents how to launch a CLI session scoped to the chosen profile.
  • Use cases include onboarding a session to act as architect/orchestrator/worker/reviewer, previewing write and tool restrictions before work, and confirming boot prompts and PCC slices for deterministic agent behavior.

Quick Start

Run /agent use architect to load and preview the architect profile for the current session.

Frequently Asked Questions about agent

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

FAQPage Schema
How do I switch to a repository-local agent persona for my current session?

To switch an agent persona, run a command like `/agent use architect` to load the corresponding `.volon/agents/` profile and apply its boot prompt and tool restrictions to the current session.

What is an agent profile in repository-local orchestration?

An agent profile is a YAML file defining a session persona by specifying its boot prompt, PCC slices, write scope, and tool allowlist to enforce deterministic behavior and guardrails for specific roles.

Can I preview write scopes and tool allowlists before applying an agent profile?

Yes, you can preview write scopes and tool allowlists by running the profile selection command, which prints a summarized view of the profile metadata and performs no persistent repository changes.

What happens if I provide an invalid agent profile slug?

If you provide an invalid agent profile slug, the system provides clear error handling and lists available profiles to help you select a valid `.volon/agents/` configuration.

Does switching session personas modify my repository files or global state?

No, switching session personas does not modify repository files or global state; the process validates the profile slug, prints metadata, and only instructs the current session to adopt the persona.