mirror of
https://github.com/msitarzewski/agency-agents
synced 2026-04-25 11:18:05 +00:00
6d58ad4c0a
OpenClaw support: - Add section-splitting convert_openclaw() to convert.sh that routes ## headers by keyword into SOUL.md (persona) vs AGENTS.md (operations) and generates IDENTITY.md with emoji + vibe from frontmatter - Add integrations/openclaw/ to .gitignore Frontmatter additions (all 112 agents): - Add emoji and vibe fields to every agent for OpenClaw IDENTITY.md generation and future dashboard/catalog use - Add services field to carousel-growth-engine (Gemini API, Upload-Post) - Add emoji/vibe to 7 new paid-media agents from PR #83 Agent quality: - Rewrite accounts-payable-agent to be vendor-agnostic (remove AgenticBTC dependency, use generic payments.* interface) Documentation: - CONTRIBUTING.md: Add Persona/Operations section grouping guidance, emoji/vibe/services frontmatter fields, external services editorial policy - README.md: Add OpenClaw to supported tools, update agent count to 112, reduce third-party OpenClaw repo mention to one-line attribution Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
480 lines
13 KiB
Bash
Executable File
480 lines
13 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
#
|
|
# convert.sh — Convert agency agent .md files into tool-specific formats.
|
|
#
|
|
# Reads all agent files from the standard category directories and outputs
|
|
# converted files to integrations/<tool>/. Run this to regenerate all
|
|
# integration files after adding or modifying agents.
|
|
#
|
|
# Usage:
|
|
# ./scripts/convert.sh [--tool <name>] [--out <dir>] [--help]
|
|
#
|
|
# Tools:
|
|
# antigravity — Antigravity skill files (~/.gemini/antigravity/skills/)
|
|
# gemini-cli — Gemini CLI extension (skills/ + gemini-extension.json)
|
|
# opencode — OpenCode agent files (.opencode/agent/*.md)
|
|
# cursor — Cursor rule files (.cursor/rules/*.mdc)
|
|
# aider — Single CONVENTIONS.md for Aider
|
|
# windsurf — Single .windsurfrules for Windsurf
|
|
# openclaw — OpenClaw SOUL.md files (openclaw_workspace/<agent>/SOUL.md)
|
|
# all — All tools (default)
|
|
#
|
|
# Output is written to integrations/<tool>/ relative to the repo root.
|
|
# This script never touches user config dirs — see install.sh for that.
|
|
|
|
set -euo pipefail
|
|
|
|
# --- Colour helpers ---
|
|
if [[ -t 1 ]]; then
|
|
GREEN=$'\033[0;32m'; YELLOW=$'\033[1;33m'; RED=$'\033[0;31m'; BOLD=$'\033[1m'; RESET=$'\033[0m'
|
|
else
|
|
GREEN=''; YELLOW=''; RED=''; BOLD=''; RESET=''
|
|
fi
|
|
|
|
info() { printf "${GREEN}[OK]${RESET} %s\n" "$*"; }
|
|
warn() { printf "${YELLOW}[!!]${RESET} %s\n" "$*"; }
|
|
error() { printf "${RED}[ERR]${RESET} %s\n" "$*" >&2; }
|
|
header() { echo -e "\n${BOLD}$*${RESET}"; }
|
|
|
|
# --- Paths ---
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
|
|
OUT_DIR="$REPO_ROOT/integrations"
|
|
TODAY="$(date +%Y-%m-%d)"
|
|
|
|
AGENT_DIRS=(
|
|
design engineering game-development marketing paid-media product project-management
|
|
testing support spatial-computing specialized
|
|
)
|
|
|
|
# --- Usage ---
|
|
usage() {
|
|
sed -n '3,22p' "$0" | sed 's/^# \{0,1\}//'
|
|
exit 0
|
|
}
|
|
|
|
# --- Frontmatter helpers ---
|
|
|
|
# Extract a single field value from YAML frontmatter block.
|
|
# Usage: get_field <field> <file>
|
|
get_field() {
|
|
local field="$1" file="$2"
|
|
awk -v f="$field" '
|
|
/^---$/ { fm++; next }
|
|
fm == 1 && $0 ~ "^" f ": " { sub("^" f ": ", ""); print; exit }
|
|
' "$file"
|
|
}
|
|
|
|
# Strip the leading frontmatter block and return only the body.
|
|
# Usage: get_body <file>
|
|
get_body() {
|
|
awk 'BEGIN{fm=0} /^---$/{fm++; next} fm>=2{print}' "$1"
|
|
}
|
|
|
|
# Convert a human-readable agent name to a lowercase kebab-case slug.
|
|
# "Frontend Developer" → "frontend-developer"
|
|
slugify() {
|
|
echo "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//'
|
|
}
|
|
|
|
# --- Per-tool converters ---
|
|
|
|
convert_antigravity() {
|
|
local file="$1"
|
|
local name description slug outdir outfile body
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
slug="agency-$(slugify "$name")"
|
|
body="$(get_body "$file")"
|
|
|
|
outdir="$OUT_DIR/antigravity/$slug"
|
|
outfile="$outdir/SKILL.md"
|
|
mkdir -p "$outdir"
|
|
|
|
# Antigravity SKILL.md format mirrors community skills in ~/.gemini/antigravity/skills/
|
|
cat > "$outfile" <<HEREDOC
|
|
---
|
|
name: ${slug}
|
|
description: ${description}
|
|
risk: low
|
|
source: community
|
|
date_added: '${TODAY}'
|
|
---
|
|
${body}
|
|
HEREDOC
|
|
}
|
|
|
|
convert_gemini_cli() {
|
|
local file="$1"
|
|
local name description slug outdir outfile body
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
slug="$(slugify "$name")"
|
|
body="$(get_body "$file")"
|
|
|
|
outdir="$OUT_DIR/gemini-cli/skills/$slug"
|
|
outfile="$outdir/SKILL.md"
|
|
mkdir -p "$outdir"
|
|
|
|
# Gemini CLI skill format: minimal frontmatter (name + description only)
|
|
cat > "$outfile" <<HEREDOC
|
|
---
|
|
name: ${slug}
|
|
description: ${description}
|
|
---
|
|
${body}
|
|
HEREDOC
|
|
}
|
|
|
|
# Map named colors to hex codes for OpenCode (which only accepts hex values).
|
|
# Colors already starting with '#' pass through unchanged.
|
|
resolve_opencode_color() {
|
|
local c="$1"
|
|
case "$c" in
|
|
cyan) echo "#00FFFF" ;;
|
|
blue) echo "#3498DB" ;;
|
|
green) echo "#2ECC71" ;;
|
|
red) echo "#E74C3C" ;;
|
|
purple) echo "#9B59B6" ;;
|
|
orange) echo "#F39C12" ;;
|
|
teal) echo "#008080" ;;
|
|
indigo) echo "#6366F1" ;;
|
|
pink) echo "#E84393" ;;
|
|
gold) echo "#EAB308" ;;
|
|
amber) echo "#F59E0B" ;;
|
|
neon-green) echo "#10B981" ;;
|
|
neon-cyan) echo "#06B6D4" ;;
|
|
metallic-blue) echo "#3B82F6" ;;
|
|
*) echo "$c" ;; # already hex or unknown — pass through
|
|
esac
|
|
}
|
|
|
|
convert_opencode() {
|
|
local file="$1"
|
|
local name description color slug outfile body
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
color="$(resolve_opencode_color "$(get_field "color" "$file")")"
|
|
slug="$(slugify "$name")"
|
|
body="$(get_body "$file")"
|
|
|
|
outfile="$OUT_DIR/opencode/agents/${slug}.md"
|
|
mkdir -p "$OUT_DIR/opencode/agents"
|
|
|
|
# OpenCode agent format: .md with YAML frontmatter in .opencode/agents/.
|
|
# Named colors are resolved to hex via resolve_opencode_color().
|
|
cat > "$outfile" <<HEREDOC
|
|
---
|
|
name: ${name}
|
|
description: ${description}
|
|
mode: subagent
|
|
color: ${color}
|
|
---
|
|
${body}
|
|
HEREDOC
|
|
}
|
|
|
|
convert_cursor() {
|
|
local file="$1"
|
|
local name description slug outfile body
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
slug="$(slugify "$name")"
|
|
body="$(get_body "$file")"
|
|
|
|
outfile="$OUT_DIR/cursor/rules/${slug}.mdc"
|
|
mkdir -p "$OUT_DIR/cursor/rules"
|
|
|
|
# Cursor .mdc format: description + globs + alwaysApply frontmatter
|
|
cat > "$outfile" <<HEREDOC
|
|
---
|
|
description: ${description}
|
|
globs: ""
|
|
alwaysApply: false
|
|
---
|
|
${body}
|
|
HEREDOC
|
|
}
|
|
|
|
convert_openclaw() {
|
|
local file="$1"
|
|
local name description slug outdir body
|
|
local soul_content="" agents_content=""
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
slug="$(slugify "$name")"
|
|
body="$(get_body "$file")"
|
|
|
|
outdir="$OUT_DIR/openclaw/$slug"
|
|
mkdir -p "$outdir"
|
|
|
|
# Split body sections into SOUL.md (persona) vs AGENTS.md (operations)
|
|
# by matching ## header keywords. Unmatched sections go to AGENTS.md.
|
|
#
|
|
# SOUL keywords: identity, memory (paired with identity), communication,
|
|
# style, critical rules, rules you must follow
|
|
# AGENTS keywords: everything else (mission, deliverables, workflow, etc.)
|
|
|
|
local current_target="agents" # default bucket
|
|
local current_section=""
|
|
|
|
while IFS= read -r line; do
|
|
# Detect ## headers (with or without emoji prefixes)
|
|
if [[ "$line" =~ ^##[[:space:]] ]]; then
|
|
# Flush previous section
|
|
if [[ -n "$current_section" ]]; then
|
|
if [[ "$current_target" == "soul" ]]; then
|
|
soul_content+="$current_section"
|
|
else
|
|
agents_content+="$current_section"
|
|
fi
|
|
fi
|
|
current_section=""
|
|
|
|
# Classify this header by keyword (case-insensitive)
|
|
local header_lower
|
|
header_lower="$(echo "$line" | tr '[:upper:]' '[:lower:]')"
|
|
|
|
if [[ "$header_lower" =~ identity ]] ||
|
|
[[ "$header_lower" =~ communication ]] ||
|
|
[[ "$header_lower" =~ style ]] ||
|
|
[[ "$header_lower" =~ critical.rule ]] ||
|
|
[[ "$header_lower" =~ rules.you.must.follow ]]; then
|
|
current_target="soul"
|
|
else
|
|
current_target="agents"
|
|
fi
|
|
fi
|
|
|
|
current_section+="$line"$'\n'
|
|
done <<< "$body"
|
|
|
|
# Flush final section
|
|
if [[ -n "$current_section" ]]; then
|
|
if [[ "$current_target" == "soul" ]]; then
|
|
soul_content+="$current_section"
|
|
else
|
|
agents_content+="$current_section"
|
|
fi
|
|
fi
|
|
|
|
# Write SOUL.md — persona, tone, boundaries
|
|
cat > "$outdir/SOUL.md" <<HEREDOC
|
|
${soul_content}
|
|
HEREDOC
|
|
|
|
# Write AGENTS.md — mission, deliverables, workflow
|
|
cat > "$outdir/AGENTS.md" <<HEREDOC
|
|
${agents_content}
|
|
HEREDOC
|
|
|
|
# Write IDENTITY.md — emoji + name + vibe from frontmatter, fallback to description
|
|
local emoji vibe
|
|
emoji="$(get_field "emoji" "$file")"
|
|
vibe="$(get_field "vibe" "$file")"
|
|
|
|
if [[ -n "$emoji" && -n "$vibe" ]]; then
|
|
cat > "$outdir/IDENTITY.md" <<HEREDOC
|
|
# ${emoji} ${name}
|
|
${vibe}
|
|
HEREDOC
|
|
else
|
|
cat > "$outdir/IDENTITY.md" <<HEREDOC
|
|
# ${name}
|
|
${description}
|
|
HEREDOC
|
|
fi
|
|
}
|
|
|
|
# Aider and Windsurf are single-file formats — accumulate into temp files
|
|
# then write at the end.
|
|
AIDER_TMP="$(mktemp)"
|
|
WINDSURF_TMP="$(mktemp)"
|
|
trap 'rm -f "$AIDER_TMP" "$WINDSURF_TMP"' EXIT
|
|
|
|
# Write Aider/Windsurf headers once
|
|
cat > "$AIDER_TMP" <<'HEREDOC'
|
|
# The Agency — AI Agent Conventions
|
|
#
|
|
# This file provides Aider with the full roster of specialized AI agents from
|
|
# The Agency (https://github.com/msitarzewski/agency-agents).
|
|
#
|
|
# To activate an agent, reference it by name in your Aider session prompt, e.g.:
|
|
# "Use the Frontend Developer agent to review this component."
|
|
#
|
|
# Generated by scripts/convert.sh — do not edit manually.
|
|
|
|
HEREDOC
|
|
|
|
cat > "$WINDSURF_TMP" <<'HEREDOC'
|
|
# The Agency — AI Agent Rules for Windsurf
|
|
#
|
|
# Full roster of specialized AI agents from The Agency.
|
|
# To activate an agent, reference it by name in your Windsurf conversation.
|
|
#
|
|
# Generated by scripts/convert.sh — do not edit manually.
|
|
|
|
HEREDOC
|
|
|
|
accumulate_aider() {
|
|
local file="$1"
|
|
local name description body
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
body="$(get_body "$file")"
|
|
|
|
cat >> "$AIDER_TMP" <<HEREDOC
|
|
|
|
---
|
|
|
|
## ${name}
|
|
|
|
> ${description}
|
|
|
|
${body}
|
|
HEREDOC
|
|
}
|
|
|
|
accumulate_windsurf() {
|
|
local file="$1"
|
|
local name description body
|
|
|
|
name="$(get_field "name" "$file")"
|
|
description="$(get_field "description" "$file")"
|
|
body="$(get_body "$file")"
|
|
|
|
cat >> "$WINDSURF_TMP" <<HEREDOC
|
|
|
|
================================================================================
|
|
## ${name}
|
|
${description}
|
|
================================================================================
|
|
|
|
${body}
|
|
|
|
HEREDOC
|
|
}
|
|
|
|
# --- Main loop ---
|
|
|
|
run_conversions() {
|
|
local tool="$1"
|
|
local count=0
|
|
|
|
for dir in "${AGENT_DIRS[@]}"; do
|
|
local dirpath="$REPO_ROOT/$dir"
|
|
[[ -d "$dirpath" ]] || continue
|
|
|
|
while IFS= read -r -d '' file; do
|
|
# Skip files without frontmatter (non-agent docs like QUICKSTART.md)
|
|
local first_line
|
|
first_line="$(head -1 "$file")"
|
|
[[ "$first_line" == "---" ]] || continue
|
|
|
|
local name
|
|
name="$(get_field "name" "$file")"
|
|
[[ -n "$name" ]] || continue
|
|
|
|
case "$tool" in
|
|
antigravity) convert_antigravity "$file" ;;
|
|
gemini-cli) convert_gemini_cli "$file" ;;
|
|
opencode) convert_opencode "$file" ;;
|
|
cursor) convert_cursor "$file" ;;
|
|
openclaw) convert_openclaw "$file" ;;
|
|
aider) accumulate_aider "$file" ;;
|
|
windsurf) accumulate_windsurf "$file" ;;
|
|
esac
|
|
|
|
(( count++ )) || true
|
|
done < <(find "$dirpath" -name "*.md" -type f -print0 | sort -z)
|
|
done
|
|
|
|
echo "$count"
|
|
}
|
|
|
|
write_single_file_outputs() {
|
|
# Aider
|
|
mkdir -p "$OUT_DIR/aider"
|
|
cp "$AIDER_TMP" "$OUT_DIR/aider/CONVENTIONS.md"
|
|
|
|
# Windsurf
|
|
mkdir -p "$OUT_DIR/windsurf"
|
|
cp "$WINDSURF_TMP" "$OUT_DIR/windsurf/.windsurfrules"
|
|
}
|
|
|
|
# --- Entry point ---
|
|
|
|
main() {
|
|
local tool="all"
|
|
|
|
while [[ $# -gt 0 ]]; do
|
|
case "$1" in
|
|
--tool) tool="${2:?'--tool requires a value'}"; shift 2 ;;
|
|
--out) OUT_DIR="${2:?'--out requires a value'}"; shift 2 ;;
|
|
--help|-h) usage ;;
|
|
*) error "Unknown option: $1"; usage ;;
|
|
esac
|
|
done
|
|
|
|
local valid_tools=("antigravity" "gemini-cli" "opencode" "cursor" "aider" "windsurf" "openclaw" "all")
|
|
local valid=false
|
|
for t in "${valid_tools[@]}"; do [[ "$t" == "$tool" ]] && valid=true && break; done
|
|
if ! $valid; then
|
|
error "Unknown tool '$tool'. Valid: ${valid_tools[*]}"
|
|
exit 1
|
|
fi
|
|
|
|
header "The Agency -- Converting agents to tool-specific formats"
|
|
echo " Repo: $REPO_ROOT"
|
|
echo " Output: $OUT_DIR"
|
|
echo " Tool: $tool"
|
|
echo " Date: $TODAY"
|
|
|
|
local tools_to_run=()
|
|
if [[ "$tool" == "all" ]]; then
|
|
tools_to_run=("antigravity" "gemini-cli" "opencode" "cursor" "aider" "windsurf" "openclaw")
|
|
else
|
|
tools_to_run=("$tool")
|
|
fi
|
|
|
|
local total=0
|
|
for t in "${tools_to_run[@]}"; do
|
|
header "Converting: $t"
|
|
local count
|
|
count="$(run_conversions "$t")"
|
|
total=$(( total + count ))
|
|
|
|
# Gemini CLI also needs the extension manifest
|
|
if [[ "$t" == "gemini-cli" ]]; then
|
|
mkdir -p "$OUT_DIR/gemini-cli"
|
|
cat > "$OUT_DIR/gemini-cli/gemini-extension.json" <<'HEREDOC'
|
|
{
|
|
"name": "agency-agents",
|
|
"version": "1.0.0"
|
|
}
|
|
HEREDOC
|
|
info "Wrote gemini-extension.json"
|
|
fi
|
|
|
|
info "Converted $count agents for $t"
|
|
done
|
|
|
|
# Write single-file outputs after accumulation
|
|
if [[ "$tool" == "all" || "$tool" == "aider" || "$tool" == "windsurf" ]]; then
|
|
write_single_file_outputs
|
|
info "Wrote integrations/aider/CONVENTIONS.md"
|
|
info "Wrote integrations/windsurf/.windsurfrules"
|
|
fi
|
|
|
|
echo ""
|
|
info "Done. Total conversions: $total"
|
|
}
|
|
|
|
main "$@"
|