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.