gitwtfhub

wtf is franke_skills?

boldprojekte/franke_skills — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A CLI that lets an AI assistant hand off coding tasks to Codex, Claude Code, or Grok as detached background workers while it plans and reviews.

Mindmap

mindmap
  root((franke_skills))
    What it does
      Delegates coding to background workers
      Unifies Codex Claude Code and Grok
      Built in code review
    Tech stack
      Python
      Codex CLI
      Claude Code
    Use cases
      Background coding tasks
      Attention first status checks
      Spec vs standards review
    Audience
      Developers using AI coding agents

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Spawn a detached coding task in Codex, Claude Code, or Grok while continuing other work.

REASON 2

Check task status without polling, since stuck or waiting tasks surface to the top.

REASON 3

Get a two-axis code review comparing finished work against standards and the original spec.

REASON 4

Steer or answer a running worker's questions from the same command-line thread.

What's in the stack?

PythonCodex CLIClaude CodeGrok

How it stacks up

boldprojekte/franke_skills0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Python 3.10 or newer and at least one supported coding CLI (Codex, Claude Code, or Grok) already installed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

franke_skills is a tool that lets a capable AI assistant, the one you are chatting with, hand off the actual coding work to separate AI coding tools running in the background, while it stays focused on planning and reviewing. The idea is that the assistant you talk to is good at breaking down a task and judging finished work, while the actual line by line coding is often better done by dedicated coding tools running on their own, with their own memory of the task, their own logs, and their own way of handling failures. The main piece included here is a single command line tool that wraps three different AI coding assistants, Codex, Claude Code, and Grok, behind one shared set of commands. Instead of learning a different way to start, check on, and collect results from each of these tools, you use the same handful of commands no matter which one is doing the work underneath. Compared to just running one of these coding tools directly in a loop, this project adds a few things. If a worker gets stuck or needs more information partway through, that shows up as a clear status you can check on, instead of the process silently failing or hanging. Checking in on running work brings the tasks that need attention to the top of the list, rather than making you scroll through everything. And a code review step is built in from the start, checking finished work both against general coding standards and against the original task description, with two separate checks run side by side and then combined into one judgment. Getting started means installing the skill for whichever coding tools you already use, which copies files into your project so your assistant can find and use them. It requires Python 3.10 or newer and at least one supported coding tool already installed. Once set up, you start a background coding task with one command, go do something else while it runs, check status later, then review and collect results, always reading the actual code changes yourself before trusting them. The project also lets you choose how much reasoning effort each backend uses for a given task, translating a single setting into the right option for whichever tool is doing the work. It is written in Python and released under the MIT license.

Yoink these prompts

Prompt 1
Help me install the cxcc-subagent skill for Codex and Claude Code in my project.
Prompt 2
Show me how to spawn a detached coding task with cdx.py and check its status later.
Prompt 3
Explain how the review step judges a worker's finished code against the original spec.
Prompt 4
Walk me through changing the reasoning effort level for a coding subagent task.

Frequently asked questions

wtf is franke_skills?

A CLI that lets an AI assistant hand off coding tasks to Codex, Claude Code, or Grok as detached background workers while it plans and reviews.

What language is franke_skills written in?

Mainly Python. The stack also includes Python, Codex CLI, Claude Code.

What license does franke_skills use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is franke_skills to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is franke_skills for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.