autonomous-skill

Execute long-running multi-session tasks across Claude Code sessions.

2|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/billlzzz26/note-taker-convex-ai-convex --skill autonomous-skill-billlzzz26
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autonomous-skill
Source: https://github.com/billlzzz26/note-taker-convex-ai-convex/tree/main/.agents/skills/autonomous-skill
Command: npx skills add https://github.com/billlzzz26/note-taker-convex-ai-convex --skill autonomous-skill-billlzzz26

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claude, jq, perl, and includes scripts (resource) components.

What problem does it solve?

Execute long-running, multi-session tasks autonomously using Claude Code headless mode or in-session hook-based loops. Supports structured task decomposition (for complex projects) and lightweight Ralph-style iteration (for TDD, bug fixing, refactoring).

Core Features & Use Cases

  • Headless Mode: Spawns claude -p child sessions in a bash loop for background work.
  • Hook Mode: Uses a Stop hook to intercept session exit and feed prompts back inside the session.
  • Structured & Lightweight: Structured creates a task_list.md with phased subtasks; Lightweight iterates with a fixed prompt.
  • Completion & Progress: Uses promise tags and checkbox counting to determine completion; progress.md tracks per-session work.
  • Project Layout: Keeps state under .autonomous and .claude directories; loads instructions from SKILL.md body.

Quick Start

Describe your task and start a session with run-session.sh to begin a structured task, or use setup-loop.sh for a hook-based loop.

Frequently Asked Questions about autonomous-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run long-running tasks across multiple Claude Code sessions?

You can run long-running tasks across Claude Code sessions by using headless mode to spawn child sessions in a bash loop, or hook mode to intercept session exits and feed prompts back. This coordinates sustained, unattended work.

What is the best way to decompose complex projects for autonomous task execution?

The best way to decompose complex projects is using structured task decomposition, which creates a task_list.md with phased subtasks. This allows the deterministic task runner to coordinate sustained work across multiple sessions.

Does autonomous task execution work with TDD and refactoring loops?

Autonomous task execution supports TDD and refactoring through lightweight Ralph-style iteration, which uses a fixed prompt to iterate tasks instead of structured subtask lists. Progress is tracked via progress.md.

How does hook mode intercept session exits for continuous workflow automation?

Hook mode intercepts session exits by using a Stop hook to feed prompts back inside the session, creating an in-session loop. This enables continuous workflow automation without spawning external child sessions.

Do I need jq and perl to manage multi-session task progress?

Yes, you need jq and perl installed as dependencies to manage multi-session task progress. These tools support the deterministic task runner and local state management required for completion detection.

Why use frontmatter-driven discovery for multi-session task coordination?

Frontmatter-driven discovery is used for multi-session task coordination because it enables deterministic task execution and local state management. It ensures proper task progress tracking and completion detection across tools.