steipete/agent-scripts

steipete 资料

最近记录的来源活动: 2026年10月15日 10:49

SkillsMP 收录数据更新: 2026年10月17日 00:09

已收集 skills: 54

GitHub 星标: 7,371
GitHub Forks: 649

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

# Agent Scripts Shared agent instructions, skills, and small portable helpers for Peter's local workspaces. This repo is the canonical place for: - `AGENTS.MD`: shared hard rules for Codex/Claude-style agents - `skills/`: reusable workflow skills, including repo-owned skills exposed by symlink - `scripts/`: dependency-light helpers used across projects - `hooks/`: local guardrails such as skill validation ## Skills Skills are the main routing layer. Each `skills/<name>/SKILL.md` has YAML front matter: ```yaml --- name: skill-name description: "Short generic trigger phrase." --- ``` Rules: - Keep descriptions short and generic; optimize for routing, not documentation. - Keep skill bodies terse and operational. - Prefer helper scripts under `skills/<name>/scripts/` when a workflow has repeatable commands. - Validate after edits: `scripts/validate-skills`. - Quote `description` in front matter. Global discovery is built by `scripts/sync-skills` (idempotent; run on every Mac after cloning or adding skills): - Codex scans nested dirs, so it gets whole-root links: `~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills`, `~/.codex/skills/manager -> ~/Projects/manager/skills`. - Claude Code loads only `~/.claude/skills/<name>/SKILL.md` (exactly one level deep; per-entry symlinks are followed, category subfolders are not scanned — verified on 2.1.197). It gets a flat per-skill link mirror covering both repos plus machine-local `~/.codex/skills/<name>` extras. - Name collisions resolve agent-scripts > manager > codex-local; the script prints skipped duplicates and prunes broken/stale managed links. - Real destination files and directories are preserved. A real Claude skill directory with a Codex backlink to that same directory satisfies local ownership; other real destination conflicts are reported and make sync fail. For the specific legacy topology `~/.claude/skills/NAME/NAME -> ~/.codex/skills/NAME -> ~/.claude/skills/NAME`, invoke the sync owner directly with an explicit allowlist: ```bash /absolute/path/to/agent-scripts/scripts/sync-skills --repair-nested-self-links --dry-run -- boxd-cli boxd-setup-deploy ``` ```bash /absolute/path/to/agent-scripts/scripts/sync-skills --repair-nested-self-links -- boxd-cli boxd-setup-deploy ``` This mode validates every candidate before unlinking only the extra nested leaves. It preserves the real skill directories, assets, and valid Codex backlinks, and exits before creating roots, building mirrors, pruning, or touching instruction pointers. Names must start with an ASCII letter or digit and contain only letters, digits, `.`, `_`, or `-`; duplicates, missing names, and unknown arguments are rejected. A missing nested leaf is a no-op only with the expected surrounding topology. Redirected/inaccessible roots, unexpected objects or literal targets, and changed directory/link identities cause refusal. Rechecks before each unlink are not atomic concurrency protection; a later error stops the batch and reports removals already completed, without rollback. The read-only `skills/fleet-maintenance/scripts/agent-skill-links-audit.sh` reports same-name nested ancestor loops as `reason=nested-self-link`. This is narrow detection, not an exhaustive graph validator. Its `--repair` remains a broad sync through `~/Projects/agent-scripts/scripts/sync-skills`; it is not the scoped repair above. Run `scripts/test-sync-skills` for isolated fixture coverage; `scripts/test-sync-skills --recurrence-only /absolute/path/to/old-sync-skills` runs the unchanged recurrence assertion against an original helper. Shared personal skills live as real folders in `skills/`. Public OpenClaw shared skills live in `../agent-skills` and are exposed here with tracked relative symlinks. Repo-owned skills stay canonical in their repo and are exposed here the same way, for example: ```text skills/autoreview -> ../../agent-skills/skills/autoreview skills/discrawl -> ../../discrawl/.agents/skills/discrawl skills/peekaboo -> ../../peekaboo/skills/peekaboo ``` Current symlinked repo-owned skills include `birdclaw`, `discrawl`, `gog`, `imsg`, `peekaboo`, `slacrawl`, `wacli`, and `wacrawl`. Keep `~/Projects/peekaboo` cloned and current before syncing the Peekaboo skill. Its `skills/peekaboo/SKILL.md` owns command, permission, capture, and interaction guidance; edit that source instead of adding another copy here. After updating both repositories, run `scripts/sync-skills` and verify the Peekaboo skill resolves through the Codex and Claude mirrors. ## Agent Instructions Shared hard rules live in `AGENTS.MD`. Global setup (also maintained by `scripts/sync-skills`; Claude Code reads `CLAUDE.md` only, so it links to the shared `AGENTS.MD`): - `~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD` - `~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD` - `~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD` Downstream repos should use a pointer-style `AGENTS.MD`: ```text READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing). ``` Repo-specific rules go below that pointer. Do not copy the shared blocks into downstream repos. ## Helpers `scripts/sync-skills` - Builds the per-machine skill mirror: Codex whole-root links, Claude flat per-skill links, shared `AGENTS.MD` pointers. - Idempotent; prints changes only, prunes broken/stale managed links, never clobbers real files. - No arguments runs ordinary sync; `--help` prints usage. Only the scoped `--repair-nested-self-links` mode accepts `--dry-run`. `scripts/validate-skills` - Checks every `skills/*/SKILL.md`. - Verifies YAML front matter plus required `name` and `description`. - Enable as a local hook with `git config core.hooksPath hooks`. `scripts/docs-list.ts` - Walks `docs/`. - Enforces `summary` and `read_when` front matter. - Prints onboarding summaries for repos that wire it in. `scripts/browser-tools.ts` - Standalone Chrome DevTools helper. - `content` and `search` fail on navigation errors; a loaded article remains readable when only network idle times out. Individual `search --content` failures are reported per result. - Common commands: `start --profile`, `nav <url>`, `eval '<js>'`, `screenshot`, `console`, `network`, `search --content "<query>"`, `content <url>`, `inspect`, `kill --all --force`. - Build optional binary with `bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools`. ## Syncing Treat this repo as canonical for shared agent rules and portable helper scripts. When syncing downstream repos: - Pull latest here first. - Ensure each target repo starts with the pointer-style `AGENTS.MD`. - Preserve repo-local rules below the pointer. - Copy helper changes both directions only when the helper is meant to stay byte-identical. - Keep scripts dependency-free and portable; no repo-specific imports or path aliases. For submodules, repeat the pointer check inside each subrepo, push those changes, then bump submodule SHAs in the parent repo. ## Releases See [RELEASING.md](RELEASING.md) for the signed-tag GitHub release workflow and its no-publish rehearsal.

正在加载仓库 README…

这个仓库中的 skills

软件开发工程师网络与计算机系统管理员综合办公文员项目管理专家

8 个职业分类 · 已分类 85%

skill

职业分类

描述

更新

codex-first

未分类

Claude Code work routing: delegate hands-on work to Codex under the native-Claude model gate. Keep specification, judgment, and verification in Claude; prefer isolated Codex-backed autoreview.

原文语言：英语

2026-10-15

remote-mac

未分类

Remote Macs: MacBooks, Mac Studios, hosted claw Macs, Tailscale, SSH, and OpenClaw.

原文语言：英语

2026-10-14

codex-huge-context

未分类

Codex 1M context: direct OpenAI Responses API inference, safe Astra/Sol/Terra/Luna input headroom, Keychain delivery, and Mac fleet rollout.

原文语言：英语

2026-10-12

npm

网络与计算机系统管理员

npm registry ops: login, whoami, names, publish; 1Password tmux.

原文语言：英语

2026-10-10

nano-banana-pro

未分类

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

原文语言：英语

2026-10-10

openclaw-relay

未分类

OpenClaw session relay: prompts/posts via local/remote acpx over SSH.

原文语言：英语

2026-10-03

markdown-converter

未分类

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

原文语言：英语

2026-09-30

video-transcript-downloader

综合办公文员

yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.

原文语言：英语

2026-09-30

release-mac-app

未分类

macOS app release: Sparkle, notarization, GitHub Release, Homebrew, closeout.

原文语言：英语

2026-09-30

github-cache-hygiene

未分类

GitHub quota/cache hygiene: Gitcrawl archives, Octopool-backed gh, freshness, limits.

原文语言：英语

2026-09-22

xcode-sync

网络与计算机系统管理员

Xcode fleet sync: signed archives, compatibility, install, selection, first launch.

原文语言：英语

2026-09-18

browser-use

软件开发工程师

Control the user's existing signed-in Chrome: callable Codex Chrome plugin first, then OpenClaw extension-backed mcporter, with direct DevTools attachment only as a last fallback.

原文语言：英语

2026-09-12

maintainer-orchestrator

项目管理专家

Coordinate multiple maintainer issues, PRs, or repositories with bounded workers, serialized public actions, and clear owner decisions. Do not use for one issue or PR.

原文语言：英语

2026-09-12

vm-lab

网络与计算机系统管理员

Parallels macOS VM lab: GUI automation, Peekaboo, TCC, Ghostty.

原文语言：英语

2026-09-06

agent-transcript

综合办公文员

Requested GitHub PR/issue agent transcripts: redact, trim, preview, and insert safely.

原文语言：英语

2026-09-05

fleet-maintenance

网络与计算机系统管理员

Mac fleet inventory and upkeep with full/worker profiles: collect installed apps and packages, compare desired versus observed state, audit local-account escrow references, update Homebrew/global packages, safely sync repos and Xcode, and report disk,…

原文语言：英语

2026-08-30

github-deep-review

软件质量保证分析师与测试员

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

原文语言：英语

2026-08-29

clawsweeper-status

网络与计算机系统管理员

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

原文语言：英语

2026-08-28

codexbar

软件开发工程师

AI service usage/quota via CodexBar CLI: Codex/OpenAI, Claude, Kimi and other provider limits, credits, reset times.

原文语言：英语

2026-08-10

project-structure

软件开发工程师

Generate a single-file compressed symbol map of a TypeScript or Swift repository — files, exported symbols, typed signatures, plugin boundaries — sized to fit an LLM context window. Use for whole-project reasoning: duplication hunting, refactor planning,…

原文语言：英语

2026-08-10

speaking

项目管理专家

Speaking ops: invites, keynotes, panels, Gmail/calendar, conferences.

原文语言：英语

2026-08-09

hopper-debugger

软件开发工程师

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

原文语言：英语

2026-08-09

telecrawl

软件开发工程师

Telegram archive: chats, messages, contacts, folders, search; import from Telegram Desktop/macOS.

原文语言：英语

2026-08-06

xurl

软件开发工程师

xurl X API CLI: install, auth, app choice, shortcuts, raw endpoints.

原文语言：英语

2026-07-11

clickclack

网络与计算机系统管理员

ClickClack ops: chat app, Cloudflare Workers deploy, DNS/docs/app, container rollout.

原文语言：英语

2026-07-05

skill-cleaner

其他计算机职业

Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.

原文语言：英语

2026-07-01

github-project-triage

软件开发工程师

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

原文语言：英语

2026-06-14

twilio-sms

软件开发工程师

Twilio SMS CLI: buy/list/keep numbers, send/check messages, credential routing.

原文语言：英语

2026-05-26

wrangler

软件开发工程师

Wrangler CLI: Workers, KV, tail, deploy, account routing.

原文语言：英语

2026-05-25

beeper

软件开发工程师

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

原文语言：英语

2026-05-23

cloudflare-registrar

软件开发工程师

Cloudflare Registrar: domain availability, prices, registration via mcporter.

原文语言：英语

2026-05-23

codex-debugging

软件开发工程师

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

原文语言：英语

2026-05-23

discord-clawd

软件开发工程师

Discord-backed OpenClaw agent/session relay; not archive search.

原文语言：英语

2026-05-23

domain-dns-ops

网络与计算机系统管理员

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

原文语言：英语

2026-05-23

frontend-design

网页与数字界面设计师

Frontend UI: pages, apps, components, polished non-generic design.

原文语言：英语

2026-05-23

github-author-context

软件开发工程师

GitHub contributor context: identity, activity, trust, company/team signal.

原文语言：英语

2026-05-23

instruments-profiling

软件开发工程师

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

原文语言：英语

2026-05-23

mac-maintenance

网络与计算机系统管理员

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

原文语言：英语

2026-05-23

native-app-performance

软件开发工程师

Native app performance: xctrace, Time Profiler, traces, hotspots.

原文语言：英语

2026-05-23

notcrawl

软件开发工程师

Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.

原文语言：英语

2026-05-23

已展示 40 / 54 个已收集 Skill。

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/steipete/agent-scripts.