Show Notes
Parker breaks down an agent-driven coding setup—the agent scripts folder—and shows how centralizing configs, prompts, and tooling can dramatically accelerate shipping and consistency across projects.
What is the Agent Scripts folder?
- A central hub of configurations, docs, and commands that point to all your other projects.
- Prevents rewriting the same setup in every repo; you point new work to the agent scripts directory first.
- Acts as a single source of truth for workflows, tooling, and “dashboards” you’ll reuse across projects.
Why this matters for engineers
- You become an “agent operator” rather than forever tweaking configs in isolation.
- Version-control for your entire tooling stack: you can evolve the agent scripts once and apply it everywhere.
- Easy access to an ops-oriented playbook: shipping, debugging, and deployment workflows are documented and referenced in one place.
Core structure you’ll encounter
- Central barrel/entry point that new folders reference first (reads agent scripts/README, etc.).
- Docs and slash commands baked in for quick access to common tasks.
- Pointers to the dotfiles and root-level scripts in each project.
- A committer script and a suite of tools (CLI helpers, prompts, etc.) that automate routine tasks.
Code example (high level)
/agent-scripts
/docs
/commands
/tools
/skills
README.md
- Your actual projects then point to this directory in their first-possible place to read agent.config or agent.mmd, so you never duplicate setup.
Key components Parker highlights
- Ghosty: the environment context Parker uses (light/dark mode, navigation around home/projects).
- Barrel file layout: a single entry point that routes to per-project configs.
- Committer script: smartly handles commits when you’re shipping lots of small changes.
- CLI tools (e.g., Nano Banana): handy utilities built into the workflow.
- Skills framework: a modular way to package capabilities (see below for structure).
- Refs and scripts: references to other tools, APIs, or open-source projects you rely on.
The “skills” concept and how to use it
- Skills are folder-based modules; the folder name is the skill name, and the file inside uses ALL CAPS with front matter.
- Front matter helps package metadata for quick reading by the agent.
- You can chain or reference skills (refs) and even script them to be called from the main workflow.
- Example pattern:
- Path: skills/create_cli/CREATE_CLI.md
- Content starts with front matter, then a concise description and usage notes.
Code block (skill file skeleton)
/skills
/create_cli
CREATE_CLI.md
Contents (example):
---
name: Create CLI
description: Scaffold a ready-to-run CLI with argument parsing
frontmatter:
category: CLI
author: Parker Rex
---
Usage:
codeex$ CREATE_CLI
...
- This packaging lets you reuse CLI scaffolds, UI/UX prompts, and other capabilities across projects without reimplementing.
How Parker uses it in practice
- He integrates this with codecs (the local workspace) and uses it as the source of truth for project scaffolding and ops tasks.
- You can point new repos to the agent scripts folder so every project inherits the same foundational setups.
- Over time, you replace or customize pieces specific to your stack while keeping a consistent baseline.
Real-world workflow benefits
- Ship more, faster: fewer repetitive setup steps across projects.
- Simplified stack maintenance: you swap in better tools (e.g., Opus or Codex) when needed without ripping out your entire workflow.
- Clearer handoffs: new team members can learn the system by reading the agent scripts and the linked docs.
Practical prompts and templates you can borrow
- Feature analysis improvement: pulls patterns from open-source work to guide UI/UX, hooks, and logic.
- Refactoring opportunities: generate an extended list of improvements (often 30+ items) and prioritize them.
- Spec interviews: prompts to surface design questions, poke holes, and clarify requirements.
- Spec-to-prompt integration: use tools like “Ask user questions” to flesh out missing spec details.
- Lists and knowledge sources: build Twitter/AI power-user lists to surface best practices and prompts.
- Park Rex has extracted prompts on parkrex.com (Writing tab, press E) you can reuse and adapt.
What this looks like in practice:
- Build a Shorts Factory prompt set to design AI-assisted educational videos.
- Use a "video gen" prompt to storyboard, fetch a CapCut-like open-source reference, and orchestrate browser APIs for audio/video handling.
Quick-start actionable steps
- Create a dedicated agent-scripts folder in your workspace and point new projects to it as the primary config source.
- Start by copying a minimal subset of Peter’s repo and tailor it to your stack (remove things you don’t need, keep the essentials you use daily).
- Define a few core skills (CLI starter, simple automation, a UI prompt) to prove the workflow and then expand.
- Document your workflow in the agent scripts README so teammates can onboard quickly.
- Experiment with the built-in prompts for feature analysis, refactoring opportunities, and spec interviews to bootstrap automation in your projects.
Takeaways
- Centralized agent scripts unlocks a repeatable, auditable, and scalable workflow across multiple projects.
- Treat your tooling like code: version, review, and evolve it rather than duplicating configs.
- Start with small, reusable SKILLS modules and gradually expand to cover your common tasks and workflows.
Links
- steipete/agent-scripts - Peter Steinberger's open source agent scripts repository
- RepoBar - macOS menu bar app for GitHub repository monitoring
- Ghostty - Fast, feature-rich terminal emulator with GPU acceleration
- OpenAI Codex vs. Claude (agents/AI tools)
- Claude Opus (execution/automation tool)
- parkerrex.com prompts page (Writing tab; press E to view prompts)
- Anthropic and related AI prompt tooling (as mentioned for follow-up prompts)