Back to Discover

ai-first-toolkit

skill

techwolf-ai

Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-engineer, and bootstrap projects with AI-first design principles.

View on GitHub
95 starsMITSynced Aug 2, 2026

Install to Claude Code

/plugin marketplace add techwolf-ai/ai-first-toolkit

README

TechWolf AI-First Toolkit

MIT License v1.11.0 Claude Code Codex Antigravity agentskills.io

Open-source agent skills from TechWolf's AI-First Bootcamp, for Claude Code, Codex, and Google Antigravity.

New here? Add the marketplace, then install any plugin below. Full commands in Quick start.

claude plugin marketplace add techwolf-ai/ai-first-toolkit

Plugins at a glance

8 plugins, 28 skills. One install command each.

PluginWhat it doesInstall
ai-firstifyAudit, re-engineer, or bootstrap any codebase to 9 AI-first design principlesclaude plugin install ai-firstify@techwolf-ai-first
content-studioThought-leadership pipeline (LinkedIn, blog, opinion) with a visual editorclaude plugin install content-studio@techwolf-ai-first
people-managementAI-augmented management: 1:1 prep, meeting prep, triage, performance cyclesclaude plugin install people-management@techwolf-ai-first
knowledge-baseEvidence-backed KB; every answer cites literal quotes from your filesclaude plugin install knowledge-base@techwolf-ai-first
ai-adoptionClaude history analytics: token-doctor and task-profileclaude plugin install ai-adoption@techwolf-ai-first
session-toolsSession continuity: find past sessions, write handoff notes, craft /goal promptsclaude plugin install session-tools@techwolf-ai-first
techwolf-brand-kitOfficial TechWolf logo assets (SVG + PNG) for AI-generated outputsclaude plugin install techwolf-brand-kit@techwolf-ai-first
tool-build-kitBuild an MCP server and bundle your tools into a shareable plugin, end to endclaude plugin install tool-build-kit@techwolf-ai-first

Not using Claude Code? Every skill follows the agentskills.io spec and installs into Codex or Google Antigravity via ./install.sh. 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:

    SkillPluginClaude Code / CoworkCodex (~/.codex/sessions)Antigravity
    session-searchsession-toolsyesyesno (degrades)
    token-doctorai-adoptionyesyes (cost via OpenAI rates)no (degrades)
    task-profileai-adoptionyesyesno (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?.

  • token-doctor: diagnoses where your token spend goes (length distribution, marathon share, cache rebuilds, per-project health) and writes a doctor-style terminal report. 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

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 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
More install commands
./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

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 (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:

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT. See CHANGELOG.md for release history.

Rendered live from techwolf-ai/ai-first-toolkit's GitHub README — not stored, always reflects the source repo.

8 Plugins

NameDescriptionCategorySource
content-studioContent studio for managing thought leadership content with a visual editor, Claude Code skills, and utility scripts../plugins/content-studio
ai-firstifyAI-first project auditor and re-engineer based on the 9 design principles and 7 design patterns from the TechWolf AI-First Bootcamp./plugins/ai-firstify
people-managementAI-augmented management tooling for people managers. Surfaces the right context at the right time. Adapts to your org's performance and management frameworks../plugins/people-management
techwolf-brand-kitOfficial TechWolf brand assets for AI-generated outputs. Provides logo files in multiple variants as SVG and PNG../plugins/techwolf-brand-kit
knowledge-baseBuild and query a structured, evidence-backed knowledge base. Every answer cites literal quotes from your KB files../plugins/knowledge-base
ai-adoptionTwo skills for analyzing your Claude history. token-doctor diagnoses where your Claude Code + Cowork spend goes. task-profile mines sessions into a role-level task map with friction and tokens. (session-search moved to session-tools.)./plugins/ai-adoption
session-toolsThree 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../plugins/session-tools
tool-build-kitBuild 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)../plugins/tool-build-kit

0 Comments

Login required
Log in to post a comment or update on this repo.

No comments yet — be the first to share an update.