Skip to content
Skills Library
AI & agents · Automation

longkeep-folder

/longkeep-folder

Run one agent CLI on a folder of repositories, unattended, with a brief the user saved once (folder tasks, built on Longkeep delegation). Use when the user says "run the folder task on <folder>", "work through these repositories overnight", "edit the folder-task brief", or asks to install the folder module.

Repository
longkeep ↗
Licence
Apache-2.0
Last repository change
30.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 30.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Run one agent CLI on a folder of repositories, unattended, with a brief the user saved once (folder tasks, built on Longkeep delegation). Use when the user says "run the folder task on <folder>", "work through these repositories overnight", "edit the folder-task brief", or asks to install the folder module.

Triggers from the description

run the folder task on <folder>work through these repositories overnightedit the folder-task brief
Original author description

Run one agent CLI on a folder of repositories, unattended, with a brief the user saved once (folder tasks, built on Longkeep delegation). Use when the user says "run the folder task on <folder>", "work through these repositories overnight", "edit the folder-task brief", or asks to install the folder module.

How it works

  1. Don'ts
Original SKILL.md headings · 22 lines, 466 words
SKILL.md preview
---
name: longkeep-folder
description: Run one agent CLI on a folder of repositories, unattended, with a brief the user saved once (folder tasks, built on Longkeep delegation). Use when the user says "run the folder task on <folder>", "work through these repositories overnight", "edit the folder-task brief", or asks to install the folder module.
---

# Longkeep folder tasks

A folder task runs one CLI on a folder, unattended, with a brief the user saved once: `~/.longkeep/folder/brief/task.md` (what to do) and `rules.md` (how). Typical use: a parent folder of repositories, and a brief that says "look at each project, pick well-founded unfinished work, do it, verify it". It builds on the delegation module: the executors, their defaults and the records are the same.

`longkeep` below means `node <repo>/packages/cli/src/cli.ts` until the package is published. Not installed yet, or the user asks to install: follow INSTALL.md in the Longkeep repository (https://github.com/wingsofsky/longkeep/blob/main/INSTALL.md).

1. **The brief.** `longkeep folder --brief` prints where it is and creates a draft on first use. A brief whose first line is still the draft marker is refused. On first use, read both files to the user, help them adapt them, and let them delete the marker line; never delete it yourself. Do not edit the brief without being asked.
2. **Run it** in the background (it can take hours): `longkeep folder <dir> --executor <id>`, or `--new-projects` for the sub-folders that are git repositories not handled before, one task per repository, in turn. The default executor is grok. Each task snapshots its working folder first; records go to `~/.longkeep/runs/<project-key>/`; the folder only gets the agent's own changes. Each task gets 30 minutes unless the executor sets `timeoutMs`. A repository that fails is reported and the rest still run; only Ctrl+C stops the whole task.
3. **One at a time.** A second folder task on the same folder is refused while one runs ("already running on this folder"); wait or stop the first.
4. **Yielding to the IDE** (macOS, IntelliJ IDEA 2026.2): with `"yieldToIde": true` on the executor in `~/.longkeep/executors.json`, a repository open in the IDE waits, and one that the user opens while it runs is stopped and resumed later, told to read the code and the git status again. When Longkeep cannot tell what the IDE has open, it waits; one failed look does not stop a running repository. Elsewhere the setting is ignored with a notice.
5. **Launch fallback**: a `fallback` list on the executor is tried only when it provably never started; every executor in it must exist, or the task refuses to start.
6. **Report back**: for each repository, the outcome and the record path from the output; then read the transcripts that matter and summarize what was done, verified and left open. Treat the agent's claims as claims until you have read its diff and test output.

Details: `<repo>/modules/folder/README.md`.

## Don'ts

- Don't edit the brief or delete its draft marker without being asked.
- Don't start a folder task on a folder the user did not name.
- Don't report a repository as done from the agent's own summary; read its diff and test output.

Versions

The database has no other skills named longkeep-folder.

Database snapshot: 13.11.2026 · package version 65801bd4c2bc (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100longkeep-delegate
    Hand subtasks to other agent CLIs on this machine and keep a record of each. Use for delegating a subtask (search and fresh facts to grok, explanations and front end to agy, multi-file code to cursor, math to codex, or an executor from ~/.longkeep/executors.json), following up…
  • 100longkeep-sessions
    Import, refresh, organize and search past agent CLI conversations (Claude Code, Codex, Gemini CLI, Grok Build, Antigravity, Cursor Agent) as Markdown archives with indexes, and distill the user's own prompts and rules from them. Use when the user says "import this project's past…
  • 95shift
    This skill should be used when the user asks to "work a shift", "run unattended", "keep working while I'm away", "guild shift", "take the night shift", "work the board while I'm out", "run autonomously", "keep going without me", "work overnight", "run until you need me", or any…
  • 100brief
    Generate a structured delegation brief. Use when assigning a task, handing off work, or briefing a sub-agent.
  • 100claude-overnight
    Understand, author, install, and inspect claude-overnight runs: a CLI that launches parallel coding agents in git worktrees with a self-curating skill memory that improves mid-run, multi-wave steering, three-layer review, and crash-safe resume. Mix Opus planner with Kimi 2.6,…
  • 90brief
    The brief file format and when a task needs one. Use when a step is about to be handed to a scout, researcher, runner, builder, reviewer, designer, checker or operator, when the person asks what a brief is or where one goes, or before writing or reading a file in a task's subagents/ folder.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.