Agent Utils

Registry • Architecture • Setup • Usage

---

🚀 The Command Center

This repository is the central intelligence hub for all Agent Personas and Skills. It provides a standardized framework for deploying AI agents across multiple projects with a single command.

📋 Active Registry

Everything in this section is fully configured and ready for production use.

Category	Component	Description
🤖 Agents	staff-engineer.md	High-level technical strategy and system design.
	security-reviewer.md	Deep security audit and vulnerability scanning.
	portfolio-manager.md	specialized Yahoo Finance portfolio tracking.
	human-editor.md	Refining AI content for human readability.
	resume-expert.md	Career guidance and resume optimization.
	data-viz-expert.md	Turning raw data into stunning visualizations.
🛠️ Skills	yahoo-finance-browser	Full browser automation for stock data.
	create-stock-chart	Dynamic chart generation for financial analysis.
📝 Workflows	publish-article	Automated flow from draft to production.
	sync-to-portfolio	Real-time synchronization of financial entries.
	commit-msg-gen	AI-powered semantic git commit generation.

🔍 View QA & Testing Suite (5 Active Agents)

• api-tester.md
• performance-benchmarker.md
• test-results-analyzer.md
• tool-evaluator.md
• workflow-optimizer.md

🌑 View Inactive/Draft Personas (22 Placeholders)

These personas are currently in "Pending Configuration" mode:

• ui-designer.md, growth-hacker.md, tiktok-strategist.md, infrastructure-maintainer.md, and 18 others.

---

🏗️ Architecture

graph TD
    A[Agent Utils Central] -->|agent-utils sync| B[Target Project]
    B --> C[.agent/personas]
    B --> D[.agent/skills]
    C --> E[Customized Agent Identity]
    D --> F[Tool Capabilities]

Loading

• agents-studio/personas/: Core identity definitions.
• agents-studio/skills/: Capability modules (JS/Browser automation).
• agents-studio/workflows/: Multi-step SOPs for agents.
• scripts/: Sync and maintenance engine.

---

⚙️ Setup & Deployment

1. Global Installation

git clone https://github.com/jonathancecilj/agent-utils.git
cd agent-utils
./install.sh

2. Project Integration (Downstream)

The import command helps you select agents and automatically builds your agent-manifest.json.

agent-utils import

3. Sync & Update

Pull the latest definitions from the central hub into your current project:

agent-utils sync

---

🛠️ Contribution Workflow

1. Draft Local: Create a new agent in your project's .agent/personas/.
2. Validate: Run agent-utils validate to check for drift.
3. Promote Upstream: Run agent-utils promote to push your improvements back to this central registry.

(back to top)