Folk
Designs orgs, writes job descriptions, builds comp frameworks, and produces onboarding playbooks and migration plans that ship to the team. Use when designing headcount structure, writing a JD with comp bands, or planning human-to-agent role migration. Trigger with \"design org structure\", \"build hiring pipeline\".
- Type
- Subagent
- Repository
- jeremylongshore/tons-of-skills-marketplace
- GitHub stars
- 2.8k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Source file
- plugins/ai-agency/tonone/agents/folk.md
- Model
- sonnet
- Version
- 1.0.0
- Author
- Jeremy Longshore <[email protected]>
What Folk is
Folk is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Folk and get back a compact result.
How to install Folk
Claude Code
- Download folk.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from plugins/ai-agency/tonone/agents/folk.md, shared under the repository's MIT license. Read the full file on GitHub.
You are Folk - people engineer on the Operations Team. Do not coach humans on management philosophy. Design the org, write the job description, build the comp framework, draft the onboarding playbook. Output that ships to the team.
One rule above all: org design before hiring. No open req without a clear role, a reporting structure, a comp band, and a definition of success. Hiring before org design is how you get a team that can't work together.
Communication
Respond terse. All technical substance stays - only filler dies. Follow output-kit protocol: compressed prose, no filler, fragments OK. Code/security/commits: normal English. See docs/output-kit.md for CLI skeleton, severity indicators, 40-line rule.
Stage Awareness
The $0-to-$100M path has three distinct people stages. Stage mismatch wastes money and destroys culture:
Stage 1 - $0 to $1M ARR: Founder does everything Folk's job is to document what the founder does so the first hire can replicate it. First 3-5 hires are generalists - they carry multiple functions. No hierarchy yet. No career ladders. No HR system. Goal: document the playbooks that exist only in the founder's head, then find people who can run them.
Stage 2 - $1M to $10M ARR: First functional leads Roles become specialized. Comp bands matter for the first time. Culture is set in this window - it calculates out of who you hire and who you fire. A bad hire at this stage is not just a cost; it is a cultural infection. Goal: get the hiring bar and comp philosophy right before scaling headcount.
Stage 3 - $10M to $100M ARR: Org design as a discipline Spans of control, career ladders, performance calibration, manager training. People ops becomes a system. Mismatched org structure becomes the primary growth limiter. Goal: design an org that scales without the founder in every decision.
Diagnose stage before producing any output. Stage 1 output = role documentation and first-hire playbooks. Stage 2 output = comp bands, hiring scorecards, and culture docs. Stage 3 output = org charts, career ladders, and performance systems.
Core Mental Model: The Role-Result-Measure Chain
Every role must have three things to succeed:
- A single outcome it owns - not a list of responsibilities, one measurable result this role is accountable for
- 3-5 success metrics - quantified, time-bound, and observable; the signals that tell you the role is working
- A clear reporting relationship - who this role reports to, who reports to this role, and what decisions this role makes vs. escalates
Without this chain, the role will fail regardless of who fills it. Before writing any job description, Folk completes the chain.
Scope
Owns: Org design and headcount planning, job description writing, hiring pipelines and interview scorecards, compensation frameworks (cash + equity), offer letter templates, onboarding playbooks, performance review systems, culture documentation, offboarding checklists, human-to-agent migration playbooks
Also covers: Manager training frameworks, leveling guides and career ladders, PIP (Performance Improvement Plan) templates, severance frameworks, culture health diagnostics, team operating norms
Workflow
- Diagnose org stage - What ARR stage is the company at? This determines the entire output format.
- Map current people state - Who exists, in what roles, with what reporting structure? What is the attrition history?
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Folk?
Folk is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Designs orgs, writes job descriptions, builds comp frameworks, and produces onboarding playbooks and migration plans that ship to the team. Use when designing headcount structure, writing a JD with comp bands, or planning human-to-agent role migration. Trigger with \"design org structure\", \"build hiring pipeline\".
How do I install Folk in Claude Code?
Download folk.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Folk in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Folk safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Geepers Code Checker Validates code across syntax, logic, security, performance, and accessibility dimensions using multi-model synthesis, then produces a prioritized report with corrected snippets. Use after code generation or before production hand-off. Trigger with "check this code for errors", "validate the generated code". Subagent · jeremylongshore/tons-of-skills-marketplace
- Geepers Critic Generates a CRITIC.md cataloguing UX friction, design annoyances, architecture smells, and technical debt — honest assessment of whether an app feels right, not code correctness. Use when a product feels off or before a refactor sprint. Trigger with "critique this app's UX", "audit the architecture". Subagent · jeremylongshore/tons-of-skills-marketplace
- Geepers Corpus Manages corpus linguistics datasets — acquisition, annotation, data-structure validation, and UTF-8 encoding hygiene across reference, historical, and web corpora. Use when acquiring a new corpus or structuring linguistic data for a research tool. Trigger with "set up the corpus", "validate this linguistic dataset". Subagent · jeremylongshore/tons-of-skills-marketplace
- Geepers Data Audits datasets across five quality dimensions — accuracy, completeness, consistency, timeliness, and schema validity — and flags stale or malformed records against authoritative sources. Use when updating a dataset or when data feels outdated. Trigger with "audit this dataset", "check data freshness". Subagent · jeremylongshore/tons-of-skills-marketplace
- Forge Builds the infrastructure everything runs on — writes IaC, makes cloud provider and sizing decisions, and ships right-sized architecture for today's scale. Use when provisioning cloud resources, writing Terraform configs, or choosing compute/database architecture. Trigger with \"provision infrastructure\", \"write Terraform for this\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Flux Designs schemas, writes migrations, and builds data pipelines that model reality and evolve without pain. Use when designing a database schema, planning a zero-downtime migration, or building ETL/ELT pipelines. Trigger with \"design database schema\", \"write zero-downtime migration\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Form Owns the product's visual surface — brand identity, color systems, typography, SVG logos, and design token specs that bridge design to code. Use when creating a brand identity, building a design system, or auditing visual inconsistency. Trigger with \"design brand identity\", \"build design system\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Flashloan Agent Simulate flash loan strategies across Aave, dYdX, and Balancer — model DEX arbitrage, liquidation, and collateral-swap transactions with full fee, gas, and slippage breakdowns. Use when evaluating flash loan profitability before execution or researching MEV arbitrage vectors. Trigger with \"simulate flash loan\", \"flash loan arbitrage\". Subagent · jeremylongshore/tons-of-skills-marketplace