openclicky-specialist-agents

Create and configure OpenClicky specialist agents with soul, memory, and skills.json wiring.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill openclicky-specialist-agents-jamsdoescode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclicky-specialist-agents
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/openclicky-specialist-agents
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill openclicky-specialist-agents-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new OpenClicky specialist agent requires creating multiple coordinated files (agent.json, soul.md, instructions.md, memory.md, HEARTBEAT.md, skills.json) in the right locations, and mistakes lead to broken or overly broad agents. This Skill provides a structured workflow to create, equip, or repair specialist agents correctly. ## Core Features & Use Cases - Agent Scaffolding: Creates a complete agent folder with agent.json, soul.md, instructions.md, memory.md, HEARTBEAT.md, and skills.json in the correct OpenClicky directories. - Skill Wiring: Associates existing bundled or learned skills via skills.json, or authors small custom SKILL.md files under the agent's own skills/ folder. - Bounded Specialist Design: Enforces narrow scope, archive-first rules for durable artifacts, and verification that enabled skills resolve locally. - Use Case: Ask OpenClicky to create a recurring maintenance agent for playlist cleanup; it inspects existing agents, writes the full file set, enables the right skill IDs, and confirms everything resolves. ## Quick Start Ask OpenClicky to create a new specialist agent for a specific recurring task and have it wire up the required skills.

Frequently Asked Questions about openclicky-specialist-agents

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

FAQPage Schema
How do I create a specialist agent in OpenClicky?

Ask OpenClicky to create a specialist agent for a narrow task. The workflow inspects existing agents, then creates one folder containing agent.json, soul.md, instructions.md, memory.md, HEARTBEAT.md, and skills.json with the required skill IDs enabled.

What files does an OpenClicky agent need?

An OpenClicky agent folder needs agent.json for display metadata, soul.md and instructions.md for behavior, memory.md for persistent context, HEARTBEAT.md for recurring runs, and skills.json listing enabled skill IDs. Optional custom skills live under the agent's skills/ folder.

Where are OpenClicky agents stored on macOS?

Built-in agents live in ~/Library/Application Support/OpenClicky/agents/, while user agents live in ~/.openclicky/agents/. A runtime map is maintained at ~/Library/Application Support/OpenClicky/AgentMode/CodexHome/OpenClickyRuntimeMap.md.

Can an OpenClicky agent use skills not in its skills.json?

No. An agent can only use a skill if its ID is listed in the agent's skills.json or the skill is written into the agent's own custom skills/ folder. The workflow verifies that every enabled skill resolves locally before finishing.

What happens when updating an existing OpenClicky agent?

The prior version of any user-authored agent or skill is archived before changes are written. This archive-first rule applies to memory, logs, skills, prompts, config, and other durable artifacts so nothing is silently overwritten.