AI Fluency

One score for how you build with AI โ€” across Claude Code, Cowork, Codex, and Cursor. Local, privacy-first.

Install in seconds
curl -fsSL https://raw.githubusercontent.com/Feloguarin/ai-fluency/main/install.sh | bash Click to copy
Requires: Python 3.8+  |  Works on: macOS, Linux, WSL  |  Best with: Claude Code (runs the AI skill-map stage)
View on GitHub

What it does

๐Ÿ”Œ

Every Tool, One Score

Claude Code, Cowork (Claude desktop), Codex โ€” including the ChatGPT desktop app โ€” and Cursor, combined into one score and one profile.

๐Ÿงฌ

Builder Archetypes

Architect, Sprinter, Debugger, Collaborator, or Autonomous Agent โ€” picked from your agency-weighted behavior, not from keywords.

โš–๏ธ

Honest by Design

Rate-based scores that volume can't inflate, confidence-hedged when data is thin, and a habit a tool can't observe is never guessed.

โœ๏ธ

Your Prompts, Rewritten

Growth cards take prompts you actually wrote and show exactly how to write them instead โ€” paste-ready, with what each change buys you.

๐Ÿ”’

100% Local

Zero network calls. Your code never leaves your machine. Read-only, never modifies source files.

โšก

Zero Config

Works out of the box with Claude Code's JSONL format. No setup, no accounts, no API keys.

Ways to use it

Pick the flow that fits โ€” every option keeps your data on your machine.

Inside Claude Code

๐Ÿงฉ The /ai-fluency skill

The full run: every tool measured, then Claude writes your skill map and rewrites your own prompts. No API key โ€” it runs on your session.

/ai-fluency
Standalone CLI

๐Ÿ”Ž One combined report

The deterministic engine on its own: one score and one profile across every tool found on this machine.

python3 insight.py --source all
Per tool

๐ŸŽ›๏ธ A single source

Zoom into one tool's picture โ€” helpful when you want to compare how you drive each agent.

python3 insight.py --source cursor
python3 insight.py --source codex
For tooling

๐Ÿ”Œ JSON export

Emit the scores, per-tool sub-scores, and data breakdown as JSON to pipe into your own scripts or dashboards.

python3 insight.py --source all --json

How it works

1

Parse

Reads every agent's local logs, read-only: Claude Code and Cowork JSONL, Codex rollout files, Cursor's SQLite (copied WAL-safely).

2

De-contaminate

Strips tool output, subagent turns, and injected harness text โ€” only prompts you actually typed are ever scored.

3

Score

Five rate-based dimensions, each blended only from the tools that can observe it, confidence-hedged when data is thin.

4

Report

One self-contained HTML report: your score, profile, per-tool source mix, and growth moves built on your own prompts.

Builder Archetypes

๐Ÿ—๏ธ

Architect

Plans and explores before building; reads and designs first

โšก

Sprinter

Fast and direct: terse prompts, quick turns, low ceremony

๐Ÿ›

Debugger

Methodical: read to diagnose, change, verify, repeat

๐Ÿค

Collaborator

Works with the agent like a teammate: options, feedback, iteration

๐Ÿค–

Autonomous Agent

Delegates whole, end-to-end jobs and trusts the agent to run them