ai-first-toolkit
Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-engineer, and bootstrap projects with AI-first design principles.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/techwolf-ai--ai-first-toolkit)HTML
<a href="/listings/techwolf-ai--ai-first-toolkit"><img src="/api/listings/techwolf-ai--ai-first-toolkit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Claude Code
claude plugin marketplace add techwolf-ai/ai-first-toolkit claude plugin install ai-firstify@techwolf-ai-first claude plugin install content-studio@techwolf-ai-first claude plugin install people-management@techwolf-ai-first claude plugin install knowledge-base@techwolf-ai-first claude plugin install ai-adoption@techwolf-ai-first claude plugin install session-tools@techwolf-ai-first claude plugin install techwolf-brand-kit@techwolf-ai-first claude plugin install tool-build-kit@techwolf-ai-first
Codex
Skills follow the [agentskills.io](https://agentskills.io) spec:
./install.sh ./install.sh ai-firstify ./install.sh content-studio ./install.sh people-management ./install.sh knowledge-base ./install.sh ai-adoption ./install.sh session-tools ./install.sh techwolf-brand-kit ./install.sh tool-build-kit
<details> <summary>More install commands</summary>
./install.sh list ./install.sh verify ./install.sh update ai-firstify ./install.sh uninstall ai-firstify ./install.sh --target ~/custom/
**What the installer does:** - Installs each skill under `~/.codex/skills/<skill-name>/` - Adds per-skill metadata for traceability back to the source plugin and version - Verifies required files are present after install - Copies plugin guidance into `~/.codex/skills/.techwolf-ai-first/plugins/<plugin>/AGENTS.md`
</details>
Google Antigravity
The same skills install into Antigravity, which keeps one self-contained dir per plugin under `~/.gemini/config/plugins/`. Pass `--ide antigravity`:
./install.sh install --ide antigravity # all plugins ./install.sh install ai-firstify --ide antigravity # one plugin ./install.sh install session-tools --ide antigravity # handoff works; session-search degrades ./install.sh list --ide antigravity ./install.sh uninstall ai-firstify --ide antigravity
Each plugin installs as `~/.gemini/config/plugins/<plugin>/` with a `plugin.json`, an `installed_version.json`, and a `skills/` directory, the same shape Antigravity uses for its own plugins. For repo-side discovery as a marketplace, Antigravity reads [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json) (the vendor-neutral `.agents/` standard), and each plugin carries an Antigravity `plugin.json` marker at `plugins/<plugin>/plugin.json`. Skills are the same `SKILL.md` files used by Claude Code and Codex, no per-target rewrite.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 52 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "techwolf-ai-first",
- "owner": {
- "name": "TechWolf",
- "email": "lennert.demey@techwolf.ai"
- },
- "metadata": {
- "description": "AI-first skills and tools from TechWolf's ai-first.techwolf.ai training program"
- },
- "plugins": [
- {
- "name": "content-studio",
- "source": "./plugins/content-studio",
- "description": "Content studio for managing thought leadership content with a visual editor, Claude Code skills, and utility scripts."
- },
- {
- "name": "ai-firstify",
- "source": "./plugins/ai-firstify",
- "description": "AI-first project auditor and re-engineer based on the 9 design principles and 7 design patterns from the TechWolf AI-First Bootcamp"
- },
- {
- "name": "people-management",
- "source": "./plugins/people-management",
- "description": "AI-augmented management tooling for people managers. Surfaces the right context at the right time. Adapts to your org's performance and management frameworks."
- },
- {
- "name": "techwolf-brand-kit",
- "source": "./plugins/techwolf-brand-kit",
- "description": "Official TechWolf brand assets for AI-generated outputs. Provides logo files in multiple variants as SVG and PNG."
- },
- {
- "name": "knowledge-base",
- "source": "./plugins/knowledge-base",
- "description": "Build and query a structured, evidence-backed knowledge base. Every answer cites literal quotes from your KB files."
- },
- {
- "name": "ai-adoption",
- "source": "./plugins/ai-adoption",
- "description": "Two skills for analyzing your Claude history. token-doctor diagnoses where your Claude Code + Cowork spend goes, including sub-agent fan-out and model mix. task-profile mines sessions into a role-level task map with friction and tokens. (session-search moved to session-tools.)"
- },
- {
- "name": "session-tools",
- "source": "./plugins/session-tools",
- "description": "Three skills for session continuity and autonomous runs. session-search finds past Claude Code and Cowork sessions by title, cwd, time range, or full-text content. handoff writes a tight resume note so a fresh session picks up exactly where the last one stopped. goal-prompt turns a task into a ready-to-paste /goal command with a measurable end state, proof, and constraints."
- },
- {
- "name": "tool-build-kit",
- "source": "./plugins/tool-build-kit",
- "description": "Build an MCP server and bundle your tools into a shareable plugin, end to end. Two skills: build-mcp scaffolds one server; build-plugin packages skills, hooks, agents, and MCP servers into an installable plugin and ships it via a marketplace. Both branch on audience (personal, org, public)."
- }
- ]
- }
README.md · README · 226 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # TechWolf AI-First Toolkit
-      
- Open-source agent skills from [TechWolf](https://techwolf.ai)'s [AI-First Bootcamp](https://ai-first.techwolf.ai), for Claude Code, Codex, and Google Antigravity.
- <!-- TODO: Replace with hero GIF showing ai-firstify audit in action -->
- **New here?** Add the marketplace, then install any plugin below. Full commands in [Quick start](#quick-start).
- ```bash
- claude plugin marketplace add techwolf-ai/ai-first-toolkit
- ```
- ## Plugins at a glance
- 8 plugins, 29 skills. One install command each.
- | Plugin | What it does | Install |
- |--------|--------------|---------|
- | **ai-firstify** | Audit, re-engineer, or bootstrap any codebase to 9 AI-first design principles | `claude plugin install ai-firstify@techwolf-ai-first` |
- | **content-studio** | Thought-leadership pipeline (LinkedIn, blog, opinion) with a visual editor | `claude plugin install content-studio@techwolf-ai-first` |
- | **people-management** | AI-augmented management: 1:1 prep, meeting prep, triage, performance cycles | `claude plugin install people-management@techwolf-ai-first` |
- | **knowledge-base** | Evidence-backed KB; every answer cites literal quotes from your files | `claude plugin install knowledge-base@techwolf-ai-first` |
- | **ai-adoption** | Claude history analytics: token-doctor and task-profile | `claude plugin install ai-adoption@techwolf-ai-first` |
- | **session-tools** | Session continuity: find past sessions, write handoff notes, craft /goal prompts | `claude plugin install session-tools@techwolf-ai-first` |
- | **techwolf-brand-kit** | Official TechWolf logo assets (SVG + PNG) for AI-generated outputs | `claude plugin install techwolf-brand-kit@techwolf-ai-first` |
- | **tool-build-kit** | Build an MCP server and bundle your tools into a shareable plugin, end to end | `claude plugin install tool-build-kit@techwolf-ai-first` |
- <a name="not-using-claude-code"></a>
- Not using Claude Code? Every skill follows the [agentskills.io](https://agentskills.io) spec and installs into Codex or Google Antigravity via [`./install.sh`](#codex). One caveat on per-platform support:
- - **Cross-platform (all skills except below):** ai-firstify, content-studio, knowledge-base, people-management, techwolf-brand-kit, tool-build-kit, and the `handoff` and `goal-prompt` skills in session-tools. These operate on your project files and prompts, so they work the same on Claude Code, Codex, and Antigravity.
- - **Host-aware (ai-adoption and session-tools):** token-doctor, task-profile, and session-search read agent **session history** off disk, which is per-platform. Each script detects the host (via the `platform` field `install.sh` stamps into each installed skill; override with `AI_FIRST_PLATFORM=claude|codex|antigravity`) and routes or degrades rather than scanning the wrong path. Support today:
- | Skill | Plugin | Claude Code / Cowork | Codex (`~/.codex/sessions`) | Antigravity |
- |---|---|---|---|---|
- | session-search | session-tools | yes | yes | no (degrades) |
- | token-doctor | ai-adoption | yes | yes (cost via OpenAI rates) | no (degrades) |
- | task-profile | ai-adoption | yes | yes | no (degrades) |
- **Antigravity** is unsupported for session analysis on purpose: the IDE stores conversations AEAD-encrypted at rest (`~/.gemini/antigravity/conversations/*.pb`), and the unencrypted CLI store carries no parseable turn/token content. Where a skill can't honestly read a platform's data it prints a clear "not available on \<platform\>" message and exits, never empty or misleading output.
- ## What's inside
- ### ai-firstify: AI-First Skill
- Audit, re-engineer, or bootstrap any codebase to align with 9 AI-first design principles and 7 design patterns. Three modes:
- - **Audit**: deep analysis across 7 dimensions with a scored report
- - **Re-engineer**: actively restructures your project to be AI-first
- - **Bootstrap**: guides new project setup with discovery questions
- ### content-studio: Thought Leadership Pipeline
- Full content pipeline for LinkedIn posts, blog posts, and opinion pieces. Includes 8 specialized skills, a visual Kanban editor, and hooks that auto-start the companion app.
- - **Write**: LinkedIn posts, blog posts, opinion pieces with voice-matched style
- - **Brainstorm**: generate ideas from URLs, files, or recent posts
- - **Analyze**: engagement pattern analysis across published content
- - **Setup**: interactive onboarding that learns your voice and creates a personalized content repo
- ### people-management: AI-Augmented Management
- AI-augmented tooling for people managers. Surfaces the right context at the right time, before meetings, during 1:1 prep, when triaging messages, or reviewing performance. Adapts to any org's frameworks and values.
- - **Setup**: interactive onboarding (10 phases) that discovers your team, frameworks, values, and ways of working
- - **8 skills**: meeting prep, 1:1 prep, triage, customer status, priority planner, team health, performance cycle
- - **Framework-agnostic**: configures to your org's performance dimensions, rating scale, management competencies, and values
- ### knowledge-base: Evidence-Backed Knowledge Base
- Build and query a structured knowledge base where every answer cites literal quotes from your KB files. Prevents hallucinations by grounding all responses in documented facts.
- - **Setup**: interactive onboarding that defines categories (flat or nested), scaffolds the KB structure, and populates from your existing sources (Notion, Slack, Confluence, local files)
- - **KB Answer**: answer questions with evidence-backed citations from your KB
- - **KB Import**: import knowledge from documents (Markdown, PDF, plain text) into structured entries, single-document or bulk-from-folder
- - **KB Refresh**: add new sources or re-scrape existing ones to keep the KB current
- - **KB Search**: `kb-search.py` keyword-ranked lookup across title, tags, description, and body, with category and tag filters
- ### ai-adoption: Claude History Analytics
- Two skills for analyzing your Claude Code + Cowork session history. Local-only, no API calls.
- > **Host-aware (reads session history off disk).** Both skills work on Claude Code / Cowork **and Codex** (`~/.codex/sessions`); token-doctor prices Codex usage with OpenAI rates. Antigravity session analysis is unsupported (encrypted IDE store). Each script detects the host and degrades with a clear message rather than scanning the wrong path. See [Not using Claude Code?](#not-using-claude-code).
- - **token-doctor**: diagnoses where your token spend goes (length distribution, marathon share, sub-agent fan-out, model mix, cache rebuilds, per-project health) and writes a doctor-style terminal report. Sub-agent and workflow-agent transcripts are rolled into the session that spawned them, so fan-out cost is visible rather than missing. Opt-in deep dive fans out parallel Haiku subagents over hotspot sessions for habit-level recommendations.
- - **task-profile**: mines sessions into a role-level map of what you actually do with AI, ranked by frequency and friction. Emits a shareable CSV, an interactive HTML explorer, AI-first coaching cards, and up to five skill proposals.
- ### session-tools: Session Continuity
- Three skills for finding past sessions, preserving the current one, and launching autonomous runs.
- - **session-search**: finds a specific past session by title, working directory, time range, or free-text content across every transcript on disk. Works on Claude Code / Cowork and Codex; Antigravity degrades with a clear message.
- - **handoff**: writes a tight `HANDOFF.md` resume note at the current working directory so a fresh session can continue without replaying the conversation. No platform dependency; works on Claude Code, Cowork, and Codex.
- - **goal-prompt**: turns a task, plan, or feature request into a ready-to-paste `/goal` command: one measurable end state, a demonstrable proof, and the constraints that must not drift. Targets Claude Code's `/goal` autonomous mode.
- ### techwolf-brand-kit: Brand Assets
- Official TechWolf brand assets for AI-generated outputs. Ensures agents use the correct logo files instead of guessing or approximating.
- - **TechWolf Logo**: 4 variants (dark, white, mono-dark, mono-white) in SVG and PNG
- - **currentColor SVG**: inline variant that inherits color from parent CSS for themed contexts
- ### tool-build-kit: Build and Ship Tools
- End-to-end guide for building an MCP server and bundling your tools into a shareable plugin, from first questions to published distribution. Two sibling skills; each asks who the work is for before building anything, then tailors every phase to that answer.
- - **build-mcp**: five phases (analyze, build, deploy, scale, distribute). Establishes audience (personal / org / public) and runtime (local stdio / hosted HTTP) with `AskUserQuestion` before writing a line of code. Builds on the Anthropic `mcp-builder` skill for implementation depth and adds the scope-and-distribution decision flow it lacks. Branch table drives deploy and distribute across five targets; 6 reference files loaded on demand (transports, local deploy, marketplace distribution, scaling, Python and TypeScript quickstarts).
- - **build-plugin**: four phases (analyze, assemble, ship, maintain). Bundles many tools (skills, hooks, agents, MCP servers) into one installable plugin and ships it via a marketplace. Establishes audience and git host with `AskUserQuestion`, then a branch table maps each phase across Just-me / Team-org-GitHub / Team-org-GitLab / Public. Picks up where build-mcp's distribute phase leaves off; 4 reference files loaded on demand (assemble, marketplace, team enablement, maintain).
- ## Quick start
- ### Claude Code
- ```bash
- claude plugin marketplace add techwolf-ai/ai-first-toolkit
- claude plugin install ai-firstify@techwolf-ai-first
- claude plugin install content-studio@techwolf-ai-first
- claude plugin install people-management@techwolf-ai-first
- claude plugin install knowledge-base@techwolf-ai-first
- claude plugin install ai-adoption@techwolf-ai-first
- claude plugin install session-tools@techwolf-ai-first
- claude plugin install techwolf-brand-kit@techwolf-ai-first
- claude plugin install tool-build-kit@techwolf-ai-first
- ```
- ### Codex
- Skills follow the [agentskills.io](https://agentskills.io) spec:
- ```bash
- ./install.sh
- ./install.sh ai-firstify
- ./install.sh content-studio
- ./install.sh people-management
- ./install.sh knowledge-base
- ./install.sh ai-adoption
- ./install.sh session-tools
- ./install.sh techwolf-brand-kit
- ./install.sh tool-build-kit
- ```
- <details>
- <summary>More install commands</summary>
- ```bash
- ./install.sh list
- ./install.sh verify
- ./install.sh update ai-firstify
- ./install.sh uninstall ai-firstify
- ./install.sh --target ~/custom/
- ```
- **What the installer does:**
- - Installs each skill under `~/.codex/skills/<skill-name>/`
- - Adds per-skill metadata for traceability back to the source plugin and version
- - Verifies required files are present after install
- - Copies plugin guidance into `~/.codex/skills/.techwolf-ai-first/plugins/<plugin>/AGENTS.md`
- </details>
- ### Google Antigravity
- The same skills install into Antigravity, which keeps one self-contained dir per plugin under `~/.gemini/config/plugins/`. Pass `--ide antigravity`:
- ```bash
- ./install.sh install --ide antigravity # all plugins
- ./install.sh install ai-firstify --ide antigravity # one plugin
- ./install.sh install session-tools --ide antigravity # handoff works; session-search degrades
- ./install.sh list --ide antigravity
- ./install.sh uninstall ai-firstify --ide antigravity
- ```
- Each plugin installs as `~/.gemini/config/plugins/<plugin>/` with a `plugin.json`, an `installed_version.json`, and a `skills/` directory, the same shape Antigravity uses for its own plugins. For repo-side discovery as a marketplace, Antigravity reads [`.agents/plugins/marketplace.json`](.agents/plugins/marketplace.json) (the vendor-neutral `.agents/` standard), and each plugin carries an Antigravity `plugin.json` marker at `plugins/<plugin>/plugin.json`. Skills are the same `SKILL.md` files used by Claude Code and Codex, no per-target rewrite.
- ## Repository structure
- ```
- ai-first-toolkit/
- ├── .claude-plugin/
- │ └── marketplace.json # Claude Code marketplace manifest
- ├── .agents/
- │ └── plugins/
- │ └── marketplace.json # Antigravity / vendor-neutral marketplace manifest
- ├── plugins/
- │ ├── ai-firstify/ # Auditor & re-engineer (1 skill, 9 reference docs)
- │ ├── content-studio/ # Content pipeline (8 skills, visual editor, hooks)
- │ ├── people-management/ # Management tooling (8 skills, 5 reference docs)
- │ ├── knowledge-base/ # Evidence-backed KB (4 skills, templates, index + verify scripts)
- │ ├── ai-adoption/ # Claude history analytics (2 skills: token-doctor, task-profile)
- │ ├── session-tools/ # Session continuity (3 skills: session-search, handoff, goal-prompt)
- │ ├── techwolf-brand-kit/ # Brand assets (logo variants in SVG + PNG)
- │ └── tool-build-kit/ # MCP + plugin builder (2 skills: build-mcp, build-plugin)
- ├── install.sh # Codex + Antigravity skill installer
- └── README.md
- ```
- Each plugin lives in `plugins/<name>/` with a `.claude-plugin/` manifest, an Antigravity `plugin.json` marker, and a `skills/` directory of `SKILL.md` files shared across all targets. See individual plugin READMEs for details:
- - [ai-firstify README](plugins/ai-firstify/README.md)
- - [content-studio README](plugins/content-studio/README.md)
- - [people-management README](plugins/people-management/README.md)
- - [knowledge-base README](plugins/knowledge-base/README.md)
- - [ai-adoption README](plugins/ai-adoption/README.md)
- - [session-tools README](plugins/session-tools/README.md)
- - [techwolf-brand-kit README](plugins/techwolf-brand-kit/README.md)
- - [tool-build-kit README](plugins/tool-build-kit/README.md)
- ## Star History
- <a href="https://www.star-history.com/?repos=techwolf-ai%2Fai-first-toolkit&type=date&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=techwolf-ai/ai-first-toolkit&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=techwolf-ai/ai-first-toolkit&type=date&legend=top-left" />
- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=techwolf-ai/ai-first-toolkit&type=date&legend=top-left" />
- </picture>
- </a>
- ## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
- ## License
- [MIT](LICENSE). See [CHANGELOG.md](CHANGELOG.md) for release history.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.