Skip to content

Adonis0123/adonis-skills / skills/ardot-mcp

ardot-mcp

Verified

This skill should be used when the user invokes /ardot-mcp or asks to package Ardot MCP through UXC, set up ardot-mcp-cli, complete Ardot OAuth for UXC, run sanitized Ardot readiness, open or inspect Ardot design files via a fixed CLI facade, or keep Grok/Claude native Ardot MCP as a compatibility path. Own Ardot endpoint identity, OAuth boundary, safe output, and task acceptance. Use uxc-facade for the generic packaging method. Do not use for one-off Ardot calls already solved by the native host MCP tools.

FileKindSize
SKILL.mdskill md5.6 KB
agents/openai.yamlconfig103 B
evals/evals.jsonconfig2.9 KB
evals/trigger-eval.jsonconfig1.4 KB
references/oauth-and-binding.mdmarkdown1.9 KB
references/uxc-facade.mdmarkdown2.0 KB
scripts/install-uxc.zshexecutablescript4.4 KB
scripts/lib/defaults.zshscript802 B
scripts/lib/uxc-link-contract.zshscript838 B
scripts/lib/uxc-owned-binary.zshscript3.5 KB
scripts/lib/uxc-release.zshscript1.3 KB
scripts/oauth-complete.zshexecutablescript1.4 KB
scripts/oauth-start.zshexecutablescript937 B
scripts/setup-auth-binding.zshexecutablescript1.9 KB
scripts/setup-uxc-link.zshexecutablescript2.3 KB
scripts/uxc-readiness.zshexecutablescript2.8 KB

scripts/uxc-readiness.zsh

View on GitHub
#!/bin/zsh

set -euo pipefail

script_dir="${0:A:h}"
skill_dir="${script_dir:h}"
source "$script_dir/lib/defaults.zsh"
source "$script_dir/lib/uxc-release.zsh"
source "$script_dir/lib/uxc-owned-binary.zsh"
source "$script_dir/lib/uxc-link-contract.zsh"

report_error() {
  print -- "STATUS=ERROR"
  print -- "SHARED_TRANSPORT=FAIL"
  print -- "ERROR_CLASS=$1"
  print -- "NATIVE_COMPAT=NOT_USED"
  exit 69
}

if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
  print -- "usage: zsh uxc-readiness.zsh [--private-result]"
  print -- "  default: shared search_style_guide proof, prints sanitized STATUS fields; --private-result: prints the JSON envelope"
  exit 0
fi

output_mode="sanitized"
if [[ $# -eq 1 && "$1" == "--private-result" ]]; then
  output_mode="private-result"
elif [[ $# -ne 0 ]]; then
  report_error "unexpected_arguments"
fi

link_dir="$(ardot_mcp_resolve_link_dir)"
link_path="$link_dir/$ARDOT_MCP_LINK_NAME"
endpoint="$ARDOT_MCP_ENDPOINT"

[[ -x /usr/bin/jq ]] || report_error "missing_jq"
ardot_mcp_uxc_link_contract_matches "$link_path" "$endpoint" "$skill_dir" || \
  report_error "link_contract_mismatch"

[[ -z "${ARDOT_MCP_UXC_BIN:-}" ]] || report_error "uxc_override_forbidden"
uxc_bin="$link_dir/uxc"
ardot_mcp_verify_owned_uxc "$uxc_bin" || report_error "foreign_uxc"
[[ "$("$uxc_bin" --version 2>/dev/null || true)" == "uxc $UXC_VERSION" ]] || report_error "version_mismatch"

tmp_dir="$(mktemp -d)"
cleanup() {
  /bin/rm -rf -- "$tmp_dir"
}
trap cleanup EXIT INT TERM

cd "$skill_dir" || report_error "fixed_cwd_missing"
exit_code=0
PATH="$link_dir:${PATH:-/usr/bin:/bin}" "$link_path" --timeout-ms 45000 search_style_guide \
  'styleKeywords=SaaS dashboard modern clean' \
  topK=1 \
  >"$tmp_dir/stdout" 2>"$tmp_dir/stderr" || exit_code=$?

if ! /usr/bin/jq -e . "$tmp_dir/stdout" >/dev/null 2>&1; then
  combined="$(<"$tmp_dir/stdout")$(<"$tmp_dir/stderr")"
  if [[ "$combined" == *"OAUTH"* || "$combined" == *"401"* || "$combined" == *"unauthorized"* ]]; then
    report_error "oauth_required"
  fi
  report_error "parse_error"
fi

if [[ "$exit_code" -ne 0 ]] || ! /usr/bin/jq -e \
  '.ok == true and .protocol == "mcp" and (.operation == "search_style_guide" or .data != null)' \
  "$tmp_dir/stdout" >/dev/null 2>&1; then
  combined="$(<"$tmp_dir/stdout")$(<"$tmp_dir/stderr")"
  if [[ "$combined" == *"OAUTH"* || "$combined" == *"401"* || "$combined" == *"unauthorized"* ]]; then
    report_error "oauth_required"
  elif [[ "$combined" == *"timed out"* || "$combined" == *"timeout"* ]]; then
    report_error "timeout"
  else
    report_error "uxc_envelope"
  fi
fi

if [[ "$output_mode" == "private-result" ]]; then
  /bin/cat "$tmp_dir/stdout"
  exit 0
fi

print -- "STATUS=READY"
print -- "SHARED_TRANSPORT=OK"
print -- "ARDOT_MCP_READY=YES"
print -- "READINESS_OPERATION=search_style_guide"
print -- "NATIVE_COMPAT=NOT_USED"
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