@gordon.chan.tavant/claude-skills

Gordon OS — composable Claude Code skills for portfolio management, client intelligence, presales, and AWS agent fleet management.

Install

npx @gordon.chan.tavant/claude-skills install --global

This does three things:

1. Installs all 32 skills to ~/.claude/skills/ (available in every Claude Code project)
2. Sets skipDangerousModePermissionPrompt: true in ~/.claude/settings.json
3. Copies AWS infrastructure scripts to ~/.claude-agent/

Open any project in Claude Code — all skills are immediately available.

Other Install Options

# Install into current project only (not global)
npx @gordon.chan.tavant/claude-skills install

# Re-install / update existing skills
npx @gordon.chan.tavant/claude-skills install --global --update

# Install a single skill
npx @gordon.chan.tavant/claude-skills install --global speckit-specify

# Install one layer only (core | compound | utility | speckit)
npx @gordon.chan.tavant/claude-skills install --global --layer speckit

# Preview what would be installed
npx @gordon.chan.tavant/claude-skills install --dry-run

# List all available skills
npx @gordon.chan.tavant/claude-skills list

AWS Infrastructure Setup (Optional)

The /agents, /task, and /desk skills require AWS infrastructure (ECS Fargate, EC2, Aurora, S3). The install command copies the deploy scripts to ~/.claude-agent/. You run them once to provision everything.

Step 1 — AWS Login

# First-time SSO setup (one-time per account)
aws configure sso --profile <your-profile>

# Login (required each session)
aws sso login --profile <your-profile>

Step 2 — Deploy Infrastructure (~15 min, one-time)

cd ~/.claude-agent
AWS_PROFILE=<your-profile> S3_BUCKET=<your-bucket> ./setup-new-user.sh

What gets deployed:

| Resource | What | Cost | |---|---|---| | S3 | Workspace sync — bidirectional Mac ↔ cloud | ~$0.02/month | | ECS Fargate | Ephemeral Claude Code agents — spin up, run, shut down | ~$0.50/month | | EC2 (t3.medium) | Always-on desk — persistent 4hr+ sessions | ~$0.03/hr while running | | Aurora Serverless | Session history and analytics | ~$1–3/month | | EventBridge | Morning brief schedule (Mon–Fri 8:03 AM) | Free |

Customization

WORKSPACE_DIR=~/Workspace \
S3_BUCKET=my-bucket \
DESK_INSTANCE_TYPE=t3.large \
AWS_PROFILE=my-profile \
  ./setup-new-user.sh

After Deploy

Everything managed through Claude Code:

/agents                    dashboard — running tasks, desk chats, history
/agents "do some research" dispatch work (auto-routes ECS vs desk)
/task run /g-morning-brief fire a one-off ECS agent
/desk open                 open EC2 persistent workstation

Skills Reference

Core Skills (5)

Single-verb building blocks. Directly invocable or chained by compound skills.

| Skill | Modes | What It Does | |---|---|---| | /g-research | full quick refresh | Web research across 9 dimensions — industry, people, financials, competitors, pain points, news, tech stack, org, culture | | /g-extract | signals entities patterns pain-points | Pull structured intelligence from any text | | /g-lookup | connections patterns conflicts playbook-match | Cross-reference signals against portfolio and playbooks | | /g-write | daily intel playbook deep-dive presales | Write canonical output files with built-in quality gate | | /g-portfolio | read score patch read-and-score | Read, score, and patch PORTFOLIO.md |

Compound Skills (7)

Full pipelines that chain core skills end-to-end.

| Skill | What It Does | |---|---| | /g-morning-brief | Full morning brief — reads Outlook, Calendar, Teams autonomously → daily intel file | | /g-deep-research <company> | Full client intel cycle → research/intel/{Company}_Client_Intel.md | | /g-presales-pack <client> | Assemble client-tailored presales artifact for a meeting | | /g-weekly-review | Monday AM portfolio health check | | /g-flywheel-extract | Extract cross-client patterns → reusable playbooks | | /g-fan-out-research | Scan intel for entities, spawn parallel research for each | | /distill-sales | Distill sales patterns from Notion meeting transcripts |

Utility Skills (4)

| Skill | What It Does | |---|---| | /agents | Universal agent interface — dashboard, dispatch, logs, history, stop | | /task | Fire ephemeral ECS Fargate agents directly | | /desk | Open/close/send/ssh EC2 persistent workstation sessions | | /safe-commit | Scan for secrets, stage, commit with conventional message |

Speckit Skills (14)

Structured software specification and implementation workflow.

| Skill | What It Does | |---|---| | /speckit-clarify | Interactive clarification before specification | | /speckit-specify | Create/update feature spec from natural language | | /speckit-plan | Generate design artifacts and implementation plan | | /speckit-tasks | Generate dependency-ordered tasks.md | | /speckit-implement | Execute implementation plan task by task | | /speckit-analyze | Cross-artifact consistency and quality analysis | | /speckit-checklist | Generate implementation checklists | | /speckit-constitution | Define and enforce project coding standards | | /speckit-taskstoissues | Convert tasks.md to GitHub issues | | /speckit-git-commit | Structured commit with conventional commits | | /speckit-git-feature | Create and manage feature branches | | /speckit-git-initialize | Initialize repo with standard structure | | /speckit-git-remote | Configure and manage git remotes | | /speckit-git-validate | Validate git state before merge or deploy |

How the AWS Fleet Works

The skills (/agents, /task, /desk) are Claude Code prompt instructions. They make AWS CLI calls to interact with infrastructure deployed by setup-new-user.sh. Nothing works without the infrastructure being deployed first.

You type: /agents "research Anchor Loans"
              ↓
Claude reads the /agents SKILL.md
              ↓
Claude runs AWS CLI to start an ECS task (short work)
  OR ssh into EC2 desk and open a tmux window (long work)
              ↓
That remote Claude agent picks up the task
              ↓
Results sync back to S3 → your ~/Workspace

Skills sync to remote agents automatically:

• Mac syncs ~/.claude/skills/ → S3 every 5 min via launchd
• ECS tasks restore skills from S3 at container startup
• EC2 desk restores skills from S3 on every boot

Add a new skill locally → available on next ECS task and desk boot automatically.

Second Machine (Existing Infrastructure)

If AWS is already deployed and you're setting up a new Mac:

# 1. Install skills
npx @gordon.chan.tavant/claude-skills install --global

# 2. Re-run setup (skips CloudFormation if stack exists, sets up rclone sync)
cd ~/.claude-agent
AWS_PROFILE=<your-profile> ./setup-new-user.sh

Workspace Layout Convention

Skills read from and write to these paths by default:

~/Workspace/
├── PORTFOLIO.md         Active engagement tracker
├── CLAUDE.md            Project instructions
├── project/             Client project directories
├── research/
│   ├── daily/           daily_intel_YYYY-MM-DD.md
│   └── intel/           {Company}_Client_Intel_*.md
└── org/
    └── playbooks/       Reusable frameworks

Troubleshooting

| Symptom | Fix | |---|---| | Skills not available after install | Restart Claude Code | | /agents says credentials expired | aws sso login --profile <your-profile> | | ECS cluster not found | cd ~/.claude-agent && ./setup-new-user.sh (idempotent) | | Desk not found | Check CloudFormation deployed; re-run setup | | SSH key missing | See DeskSSHKeyCommand in CloudFormation outputs | | Skills missing on remote agent | rclone sync ~/.claude/skills s3-workspace:<bucket>/.claude-global/skills | | Workspace out of sync | rclone bisync ~/Workspace s3-workspace:<bucket> --resync |

Maintenance

# Update skills on this machine
npx @gordon.chan.tavant/claude-skills install --global --update

# Build and publish a new version (requires source workspace)
cd ~/Workspace && ./build-package.sh           # build only
cd ~/Workspace && ./build-package.sh --publish  # build + npm publish

Version History

| Version | What Changed | |---|---| | 0.3.0 | Unified install command. Skills + infra scripts in one step. agents, task, desk, pptx-screenshot added. | | 0.2.0 | Primitives layer, standardized contracts (26 skills) | | 0.1.0 | Initial skill library (16 skills) |