AICADE Galaxy Skills#

Use This Skill When#

• The user wants to use AICADE Galaxy platform capabilities from https://www.aicadegalaxy.com/
• The user wants AI payment, paid API, membership, subscription, earning, or token-based tool access
• The user wants to discover the latest platform tools from the AICADE Galaxy gateway

Core Rule#

• On first install or first activation, always run bootstrap before doing anything else
• bootstrap must complete environment setup and artifact export in the same flow
• Do not call invoke_artifact before bootstrap succeeds
• Host integrations should read skill-entry.json as the machine-readable source of truth for install, export, list, and invoke commands
• If the host platform supports an install hook or post-install command, bind it to scripts/bootstrap.mjs or scripts/bootstrap.py
• If the host platform does not support install hooks, the first command after install must still be bootstrap

Runtime Rule#

• Prefer node first
• If node is unavailable, use python3
• If both are unavailable, ask the user to install Node.js

Required Environment#

This skill uses these .env variables:

• AICADE_GALAXY_BASE_URL
• AICADE_GALAXY_API_KEY
• AICADE_GALAXY_OUTPUT_PATH

Authentication:

• Header name: X-API-Key
• Header value source: AICADE_GALAXY_API_KEY

Default output directory:

• output

Install And Prepare#

Run this on install or first activation:

bash

node {baseDir}/scripts/bootstrap.mjs

Fallback when node is unavailable:

bash

python3 {baseDir}/scripts/bootstrap.py

Bootstrap behavior:

• Checks whether .env already has required values
• Runs setup_env when values are missing
• Runs export_artifact immediately after setup
• Produces {AICADE_GALAXY_OUTPUT_PATH}/aicade-galaxy-skill.json

Main Capabilities#

Discover Current Platform Tools#

Export the latest dynamic tool list from /admin/gateway/services:

bash

node {baseDir}/scripts/export_artifact.mjs

Fallback:

bash

python3 {baseDir}/scripts/export_artifact.py

Artifact path:

{AICADE_GALAXY_OUTPUT_PATH}/aicade-galaxy-skill.json

Invoke A Platform Tool#

Pass request parameters through an args file:

bash

node {baseDir}/scripts/invoke_artifact.mjs --artifact {AICADE_GALAXY_OUTPUT_PATH}/aicade-galaxy-skill.json --tool TOOL_NAME --args-file /tmp/invoke.json

Fallback:

bash

python3 {baseDir}/scripts/invoke_artifact.py --artifact {AICADE_GALAXY_OUTPUT_PATH}/aicade-galaxy-skill.json --tool TOOL_NAME --args-file /tmp/invoke.json

Args file example:

json

{
  "city": "Beijing",
  "responsePaths": ["reason", "error_code"]
}

Invoker behavior:

• Reads the artifact and finds the target tool by name
• Reads parameters from --args-file
• Validates required fields against inputSchema
• Calls the real platform endpoint with the tool's metadata
• Returns normalized JSON output

Normalized output:

• Success: {"ok": true, "status": 200, "tool": "...", "serviceId": "...", "data": ..., "raw": ...}
• Failure: {"ok": false, "status": 4xx/5xx, "tool": "...", "serviceId": "...", "error": {"message": "...", "raw": ...}}

List Current Supported Tools#

SKILL.md does not hardcode the live service list. The latest supported tools come from the exported artifact.

Use:

bash

node {baseDir}/scripts/list_tools.mjs --artifact {AICADE_GALAXY_OUTPUT_PATH}/aicade-galaxy-skill.json

Fallback:

bash

python3 {baseDir}/scripts/list_tools.py --artifact {AICADE_GALAXY_OUTPUT_PATH}/aicade-galaxy-skill.json

Use the artifact or list_tools result as the source of truth for current services.