Agent skill

Pilot AWS Daemon Operations

by qf-studio in qf-studio/pilot

Checks status, tails logs, queries the task queue, and starts, stops or restarts the Pilot daemon running on a specific AWS EC2 instance over SSM.

Custom licenceAuto-check: notesDevOps & Cloud

Install Pilot AWS Daemon Operations

skills CLI
$ npx skills add qf-studio/pilot --skill pilot-aws -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qf-studio/pilot pilot-aws --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qf-studio/pilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/pilot-aws .claude/skills/pilot-aws && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pilot-aws
GitHub stars
721
Token cost
~3k tokens
SKILL.md length
1,091 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Custom licence

At a glance

Checks status, tails logs, queries the task queue, and starts, stops or restarts the Pilot daemon running on a specific AWS EC2 instance over SSM.

  • Works in 6 steps: One daemon, ever. Never start pilot… → Never touch the path shims… → GitHub API is one shared per-USER pool… → …
  • Checking whether the Pilot daemon on the AWS box is healthy
  • SKILL.md covers Constants, The SSM command pattern (used…, Operations and Hard rules, plus 2 more sections
  • Calls aws, git and curl

What it does

This skill operates a Pilot daemon that was moved from running locally to a single AWS EC2 instance reached through AWS Systems Manager send-command, under a dedicated AWS profile and region. It starts every check with a zero-cost local status script before touching GitHub's shared quota, and offers a live tmux dashboard reached over SSM to watch the daemon directly.

Beyond status, it tails the daemon's log file with common filters, runs read-only SQLite queries against the daemon's own queue and ledger tables to see what is running or queued, and can stop, start, rebuild, upgrade or restart the daemon - though stop, start and restart are flagged as operator-consent actions that should not be taken autonomously during unattended runs. It also covers shipping files to the box by base64-encoding their contents, since inline heredocs do not survive the SSM command format.

It carries a few warnings specific to this box: never press q or Ctrl-C inside the live tmux session, since that kills the daemon, and never filter queue timestamps as strings across a known cutover date, since older rows use a different timestamp format.

When your agent uses it

  • Checking whether the Pilot daemon on the AWS box is healthy
  • Reading the Pilot daemon's logs or task queue over SSM
  • Restarting or rebuilding the Pilot daemon on its EC2 instance

Example prompts

  • “Check the Pilot daemon status on the AWS box.”
  • “Tail the last 50 lines of the Pilot daemon's log for rate limit errors.”
  • “Show me which tasks are currently running or queued on the box.”

Requirements

  • AWS CLI configured with the target profile
  • AWS Systems Manager access to the EC2 instance
  • Pre-approved tools (allowed-tools): Bash, Read

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. One daemon, ever. Never start pilot locally while the box serves the
  2. Never touch the path shims (/Users/aleks.petrov/... symlinks on the
  3. GitHub API is one shared per-USER pool (5000/hr) across every token,
  4. Secrets: never echo tokens/keys; never ps full args of processes holding
  5. Trust the ledger over dashboard panels (known mislabel: awaiting_approval
  6. Name your ledger. Every status/diagnosis claim must state which data

What it can do on your machine

Read from SKILL.md and the folder at commit 47c307f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • aws
    • git
    • curl
    • make

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use aws, git and curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pilot AWS Daemon Operations loads about 3k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 1,091 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:22
    al/bin/pilot is a SYMLINK to it — never `sudo install` over the symlink; rollback at pilot.prev
  • NoteRuns commands with sudoSKILL.md:61
    e daemon. Fallback: plain ssm session → `sudo su - ec2-user` →
  • NoteRuns commands with sudoSKILL.md:88
    SSM: sudo -iu ec2-user tmux send-keys -t pilot C-c   # TUI quit = graceful shutdown
  • NoteRuns commands with sudoSKILL.md:91
    SSM: sudo -iu ec2-user tmux new-session -d -s pilot -x 220 -y 50 /home/ec2-user/start-pilot.sh
  • NoteRuns commands with sudoSKILL.md:100
    SSM (as ec2-user, NO sudo — dir is ec2-user-owned since 2026-07-19):
  • NoteRuns commands with sudoSKILL.md:120
    sudo su - ec2-user
  • NoteRuns commands with sudoSKILL.md:158
    mon opened a DB at an unshimmed path) | `sudo readlink /proc/$(pgrep -x pilot)/fd/*` must include `/var/lib/pilot/pilot-
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,091 words (~3,008 tokens).

“Since the S6-lite cutover (2026-07-16, TASK-409) the Pilot daemon runs on an EC2 box, NOT locally. Local pgrep pilot returning 0 is correct.”

— opening of SKILL.md by qf-studio, Custom licence
name
pilot-aws
allowed-tools
Bash, Read
version
1.0.0

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/pilot-aws of qf-studio/pilot.

Open the folder on GitHubat commit 47c307f

Compare with similar skills

Pilot AWS Daemon Operations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pilot AWS Daemon Operations compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pilot AWS Daemon Operations this skillqf-studio/pilot721—~3kAutomated safety check: NotesCustom licence
Auto tmux Operatortradecatlabs/vibe-coding-cn17k—~4.7kAutomated safety check: PassMIT
Setup Osworldxlang-ai/OSWorld-V23551 repos~2.6kAutomated safety check: NotesApache-2.0
Linux Troubleshooting with Inspektor Gadgetinspektor-gadget/inspektor-gadget2.9k—~2.4kAutomated safety check: NotesApache-2.0
Agent Advisoraws/agent-toolkit-for-aws2.8k—~4.9kAutomated safety check: PassApache-2.0
Logfire Infrastructurepydantic/skills140—~1.8kAutomated safety check: PassMIT

Similar skills

  • Auto tmux Operator

    tradecatlabs/vibe-coding-cn

    Operates tmux sessions like an administrator: reads pane output, sends keys, inspects many panes at once, and coordinates multiple AI terminals through a swarm state script, built on oh-my-tmux.

    17k GitHub stars~4.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Setup Osworld

    xlang-ai/OSWorld-V2

    Provision and verify an OSWorld-V2 checkout after clone. An agent skill from xlang-ai/OSWorld-V2.

    355 GitHub starsUsed in 1 repo~2.6k tokens
    DevOps & CloudAuto-check: notes
  • Linux Troubleshooting with Inspektor Gadget

    inspektor-gadget/inspektor-gadget

    Debugs a single Linux host or container runtime at the kernel level with the standalone ig binary and eBPF gadgets, read-only and without Kubernetes.

    2.9k GitHub stars~2.4k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Agent Advisor

    aws/agent-toolkit-for-aws

    Official

    Entry point for AI-agent work on AWS: pick a runtime, plan a migration for existing workloads, and build an executable POC — one phased flow.

    2.8k GitHub stars~4.9k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Logfire Infrastructure

    pydantic/skills

    Official

    Monitor hosts, Docker containers, Kubernetes clusters, database/queue/cache servers, and cloud-provider metrics with Pydantic Logfire — no application code required.

    140 GitHub stars~1.8k tokensUpdated 8 days ago
    DevOps & CloudAuto-check passed
  • AWS Cost Operations

    zxkane/aws-skills

    AWS cost optimization, monitoring, and operational excellence expert.

    367 GitHub stars~2.4k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check passed

More from qf-studio/pilot

  • Pilot Failure Triage

    qf-studio/pilot

    Checks a failing Pilot executor against four known failure patterns from the v2.149.x fixes before the agent explores anything else.

    721 GitHub stars~548 tokensUpdated yesterday
    Auto-check: notes

Categories

Questions about Pilot AWS Daemon Operations

What does Pilot AWS Daemon Operations do?

Checks status, tails logs, queries the task queue, and starts, stops or restarts the Pilot daemon running on a specific AWS EC2 instance over SSM. This skill operates a Pilot daemon that was moved from running locally to a single AWS EC2 instance reached through AWS Systems Manager send-command, under a dedicated AWS profile and region. It starts every check with a zero-cost local status script before touching GitHub's shared quota, and offers a live tmux dashboard reached over SSM to watch the daemon directly.

When should I use Pilot AWS Daemon Operations?

Pilot AWS Daemon Operations fits situations like: checking whether the Pilot daemon on the AWS box is healthy; reading the Pilot daemon's logs or task queue over SSM; restarting or rebuilding the Pilot daemon on its EC2 instance.

How do I install Pilot AWS Daemon Operations in Claude Code?

Run `npx skills add qf-studio/pilot --skill pilot-aws -a claude-code`. Or copy the skill folder (.claude/skills/pilot-aws in qf-studio/pilot) into .claude/skills/pilot-aws in your project. Claude Code loads it when a task matches its description.

How do I install Pilot AWS Daemon Operations in Codex?

Run `npx skills add qf-studio/pilot --skill pilot-aws -a codex`. Or copy the skill folder (.claude/skills/pilot-aws in qf-studio/pilot) into .agents/skills/pilot-aws in your project. Codex loads it when a task matches its description.

Can I use Pilot AWS Daemon Operations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qf-studio/pilot --skill pilot-aws -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pilot-aws, .gemini/skills/pilot-aws, .github/skills/pilot-aws and .opencode/skills/pilot-aws in your project.

What does Pilot AWS Daemon Operations need to run?

Going by SKILL.md and its folder, Pilot AWS Daemon Operations needs the command-line tools its instructions call (aws, git, curl and make). Our summary lists: AWS CLI configured with the target profile; AWS Systems Manager access to the EC2 instance. Its frontmatter pre-approves these tools: Bash, Read.

Does Pilot AWS Daemon Operations access the network?

SKILL.md contains no URLs. Its commands use git and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Pilot AWS Daemon Operations safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo; pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Pilot AWS Daemon Operations use?

Pilot AWS Daemon Operations has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Pilot AWS Daemon Operations use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pilot AWS Daemon Operations?

Skills that share tags, products or a category with Pilot AWS Daemon Operations: Auto tmux Operator (tradecatlabs/vibe-coding-cn, 17k stars), Setup Osworld (xlang-ai/OSWorld-V2, 355 stars), Linux Troubleshooting with Inspektor Gadget (inspektor-gadget/inspektor-gadget, 2.9k stars) and Agent Advisor (aws/agent-toolkit-for-aws, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pilot AWS Daemon Operations?

qf-studio (a GitHub organization) maintains it in qf-studio/pilot, which has 721 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

Source: qf-studio/pilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.