setup-new-acpx-key

Configure ACPX agent credentials across a Tlamatini repository.

14|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/XAIHT/Tlamatini --skill setup-new-acpx-key
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-new-acpx-key
Source: https://github.com/XAIHT/Tlamatini/tree/main/Tlamatini/agent/skills_pkg/setup_new_acpx_key
Command: npx skills add https://github.com/XAIHT/Tlamatini --skill setup-new-acpx-key

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a guided, end-to-end workflow to configure ACPX agent credentials across a Tlamatini repository. It ensures that per-agent environment variables, top-level API keys, and the required tooling are consistently applied so ACPX-initiated agents can authenticate reliably in all workflows.

Core Features & Use Cases

  • End-to-end credential provisioning for a single or multiple ACPX agents (claude, gemini, codex, qwen, etc.).
  • Updates both global data.keys and per-agent env mappings in Tlamatini/agent/config.json, and coordinates with regen_secrets.py for keyed values.
  • Validates changes with the ACPX doctor workflow to verify resolvable agents and authenticated sessions.

Quick Start

Add a new ACPX agent credential by updating data.keys, regenerating the keyed config with regen_secrets.py, and validating the integration with acp_doctor.

Frequently Asked Questions about setup-new-acpx-key

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

FAQPage Schema
How do I configure a new ACPX agent API key in my repository?▼

Configuring ACPX agent credentials involves updating data.keys and Tlamatini/agent/config.json, running regen_secrets.py to apply keyed values, and validating the setup with acp_doctor for authenticated execution.

What is the process for adding agent credentials for multiple AI agents like Claude or Gemini?▼

Adding credentials for multiple agents like Claude or Gemini requires updating data.keys and merging top-level and per-agent environment configurations in Tlamatini/agent/config.json, coordinated through regen_secrets.py.

Do I need the CLI resolvable before setting up ACPX credentials?▼

Yes, setting up ACPX credentials requires the CLI to be resolvable so the regen_secrets workflow and acp_doctor can validate the agent configurations and ensure authenticated sessions across the repository.

Why does my ACPX agent fail authentication after updating config.json?▼

ACPX agent authentication can fail if top-level and per-agent environment configurations are not properly merged, or if regen_secrets.py was not run to sync keyed values in data.keys with the agent config file.

Can I use this workflow to provision environment variables for any supported agent_id?▼

Yes, this workflow provisions environment variables for any supported agent_id such as claude, gemini, codex, qwen, or cursor by applying both global data.keys and per-agent env mappings consistently.

What's the best way to validate ACPX credential changes across a repository?▼

The best way to validate ACPX credential changes is by running the acp_doctor workflow, which verifies that agents are resolvable and that authenticated sessions are correctly established across all workflows.