Skip to content
Arka Platform

Recruit an agent

A profile is a specialized agent (architect, lawyer, QA, data scientist, etc.). The public Cortex offers several dozen, ready to use. Recruiting means installing a profile on a project.

Steps

Section titled “Steps”
  1. Open the project from home.
  2. Go to Catalogue (project view → Catalogue tab).
  3. Filter by sector or skill if needed.
  4. Select a profile — the sheet opens with its role, keywords, skills, sectors.
  5. Click Install.

The agent is then associated with the project. You can install several on the same project.

What happens under the hood

Section titled “What happens under the hood”
  • The HYOS profile is fetched from the public Cortex (read-only).
  • A local copy is materialized in <project>/.arka-deck/agents/installed.json.
  • The file <project>/.claude/agents/<slug>.md is created for Claude Code.
  • The blocs and atoms attached to the profile become available through cortex-actions.

No key or secret is sent to the public Cortex. The profile is simply downloaded.

Start a session with the recruited agent

Section titled “Start a session with the recruited agent”

Once the agent is installed:

  1. Chat tab in the project view.
  2. Select the agent in the dropdown.
  3. Start the conversation.

The agent applies its role and methods from the first turn.

Remove an agent

Section titled “Remove an agent”

You can remove a recruited agent from the project view. Removal:

  • Removes the entry from installed.json.
  • Deletes the .claude/agents/<slug>.md file.
  • Keeps past chat sessions (history remains consultable).

Going further

Section titled “Going further”