Skip to content

LeoYeAI/agent-master-skills / skills/alchemy-openapi-skill

alchemy-openapi-skill

Verified

Operate Alchemy Prices API reads through UXC with a curated OpenAPI schema, path-templated API-key auth, and read-first guardrails.

FileKindSize
.clawhub/origin.jsonconfig153 B
SKILL.mdskill md4.0 KB
_meta.jsonconfig140 B
agents/openai.yamlconfig305 B
references/alchemy-prices.openapi.jsonconfig5.1 KB
references/usage-patterns.mdmarkdown1.6 KB
scripts/validate.shscript2.7 KB

scripts/validate.sh

View on GitHub
#!/usr/bin/env bash
set -euo pipefail

ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
SKILL_DIR="${ROOT_DIR}/skills/alchemy-openapi-skill"
SKILL_FILE="${SKILL_DIR}/SKILL.md"
OPENAI_FILE="${SKILL_DIR}/agents/openai.yaml"
USAGE_FILE="${SKILL_DIR}/references/usage-patterns.md"
SCHEMA_FILE="${SKILL_DIR}/references/alchemy-prices.openapi.json"

fail() {
  printf '[validate] error: %s\n' "$*" >&2
  exit 1
}

need_cmd() {
  command -v "$1" >/dev/null 2>&1 || fail "required command not found: $1"
}

need_cmd jq
need_cmd rg

for file in "${SKILL_FILE}" "${OPENAI_FILE}" "${USAGE_FILE}" "${SCHEMA_FILE}"; do
  [[ -f "${file}" ]] || fail "missing required file: ${file}"
done

jq -e '.openapi and .paths' "${SCHEMA_FILE}" >/dev/null 2>&1 || fail 'invalid OpenAPI schema JSON or missing .openapi/.paths'
jq -e '.paths["/tokens/by-symbol"] and .paths["/tokens/by-address"] and .paths["/tokens/historical"]' "${SCHEMA_FILE}" >/dev/null 2>&1 || fail 'OpenAPI schema missing expected Alchemy paths'
jq -e '.paths["/tokens/by-symbol"].get and .paths["/tokens/by-address"].post and .paths["/tokens/historical"].post' "${SCHEMA_FILE}" >/dev/null 2>&1 || fail 'OpenAPI schema must expose GET /tokens/by-symbol and POST /tokens/by-address,/tokens/historical'

rg -q '^name:\s*alchemy-openapi-skill\s*$' "${SKILL_FILE}" || fail 'invalid skill name'
rg -q '^description:\s*.+' "${SKILL_FILE}" || fail 'missing description'

rg -q 'command -v alchemy-openapi-cli' "${SKILL_FILE}" || fail 'missing link-first command check'
rg -q 'uxc link alchemy-openapi-cli https://api.g.alchemy.com --schema-url ' "${SKILL_FILE}" || fail 'missing fixed link create command with schema-url'
rg -F -q 'alchemy-openapi-cli get:/tokens/by-symbol -h' "${SKILL_FILE}" || fail 'missing operation-level help example'
rg -q -- '--path-prefix-template "/prices/v1/\{\{secret\}\}"' "${SKILL_FILE}" || fail 'missing path-prefix auth setup'
rg -q 'uxc auth binding match https://api.g.alchemy.com' "${SKILL_FILE}" || fail 'missing binding match check'
rg -q 'prices-only' "${SKILL_FILE}" || fail 'missing prices-only guardrail'
rg -q 'single `symbols=<TOKEN>` query' "${SKILL_FILE}" || fail 'missing by-symbol single-symbol guidance'

if rg -q -- "--args\\s+'\\{" "${SKILL_FILE}" "${USAGE_FILE}"; then
  fail 'found banned legacy JSON argument pattern'
fi

rg -q '^\s*display_name:\s*"Alchemy Prices API"\s*$' "${OPENAI_FILE}" || fail 'missing display_name'
rg -q '^\s*short_description:\s*".+"\s*$' "${OPENAI_FILE}" || fail 'missing short_description'
rg -q '^\s*default_prompt:\s*".*\$alchemy-openapi-skill.*"\s*$' "${OPENAI_FILE}" || fail 'default_prompt must mention $alchemy-openapi-skill'

echo "skills/alchemy-openapi-skill validation passed"
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall