ai-firstify

$npx mdskill add techwolf-ai/ai-first-toolkit/ai-firstify

Analyzes, re-engineers, or bootstraps projects for AI-first design.

  • Audits existing projects for AI-first compliance across 7 dimensions.
  • Depends on reference files for audit and re-engineering procedures.
  • Selects mode based on user request: audit, re-engineer, or bootstrap.
  • Outputs scored reports or actively restructures project files.

SKILL.md

.github/skills/ai-firstifyView on GitHub ↗
---
name: ai-firstify
description: "Analyze, re-engineer, or bootstrap projects to align with AI-first design principles. Use when asked to review, audit, improve, 'ai-firstify', or start a new project. Performs deep analysis across 7 dimensions, actively restructures existing projects, or guides new project setup through discovery questions. Based on the 9 design principles and 7 design patterns from the TechWolf AI-First Bootcamp."
---

# AI-Firstify

Analyze and re-engineer projects to align with AI-first design principles.

## Trigger

Use this skill when asked to:
- **Audit mode** (read-only): "review", "audit", "analyze", "check", "assess"
- **Re-Engineer mode** (active changes): "ai-firstify", "fix", "improve", "re-engineer", "transform"
- **Bootstrap mode** (new project): "start", "new project", "bootstrap", "set up", "build from scratch"

## Mode 1: Audit (Read-Only Analysis)

Perform a comprehensive read-only analysis across 7 dimensions. Output a scored report with recommendations. Do NOT modify any files.

Read **references/mode-audit.md** for the full audit procedure and dimension checklist.

## Mode 2: Re-Engineer (Active Transformation)

First, perform the full audit (Mode 1). Then actively fix issues in 7 phases: foundation, de-agentification, skill extraction, complexity reduction, context hygiene, safety hardening, workflow optimization.

Read **references/mode-reengineer.md** for the full re-engineering procedure.

## Mode 3: Bootstrap (New Project Setup)

Guide the user through setting up a new AI-first project from scratch. Interactive: ask discovery questions, recommend architecture, scaffold, and test.

Read **references/mode-bootstrap.md** for the full bootstrap procedure.

## Reference Files

Domain knowledge (load on demand per dimension):

- **references/principles.md**: All 9 AI-first design principles in depth
- **references/patterns.md**: All 7 design patterns with implementation guidance
- **references/anti-patterns.md**: Common mistakes with detection patterns and fixes
- **references/skill-architecture.md**: How to structure skills, sub-agents, and workflows
- **references/project-structure.md**: Ideal project layouts, CLAUDE.md templates, .gitignore
- **references/assessment-rubric.md**: Scoring criteria and report template

Load the relevant reference file for the dimension you are currently analyzing. Do not load all references at once. Use progressive disclosure.

## Tools

- **scripts/validate-report.sh**: Validates that a generated assessment report has all required sections, dimensions, and scores

More from techwolf-ai/ai-first-toolkit

SkillDescription
brainstorm-linkedinGenerate LinkedIn post ideas from external sources (files, URLs, research). Use when the user provides source material (PDFs, URLs, articles) to brainstorm topics. NOT for writing or developing drafts - use write-linkedin-post instead.
brainstorm-opinionGenerate opinion piece ideas from recent LinkedIn posts (last 30 days). Use when asked to find opinion topics, brainstorm article ideas, or cross-pollinate content between LinkedIn and opinion pieces.
build-mcpBuild an MCP server end to end, tailored to how it will be used. Use when asked to build an MCP, create an MCP server, wrap an API as a tool, make a tool for Claude, expose a service to an agent, build a Claude connector, or turn a service into MCP tools. Asks up front who the server is for (just me, my org, or public) and what it wraps, then walks through analyze, build, deploy, scale, and distribute with steps tailored to that answer. Builds on the example-skills:mcp-builder skill for implementation depth.
content-studioEntry point for the TechWolf content-studio plugin. Use to understand the workflow, pick the right content skill, or start setup for a new author/repository.
customer-statusSynthesised view of account health and activity for managers overseeing customer-facing teams (Sales, CS, Professional Services, Presales). Scans project channels, email threads, and Notion pages to surface status, risks, and upcoming milestones, without requiring the manager to trawl through individual channels. Supports proactive account management.
goal-promptTurn a task, plan, or feature request into a ready-to-paste Claude Code /goal command — a single completion condition with a measurable end state, a demonstrable proof, and the constraints that must not drift. Use when the user says "give me a goal", "goal prompt", "make this a /goal", "turn this into a goal", or wants an autonomous long-running objective for Claude Code.
kb-answer|
kb-import|
kb-refresh|
one-on-one-prepDeep-dive preparation for 1:1 meetings with direct reports. Surfaces recent work, wins, friction, wellbeing signals, and development goal progress, anchored in the org's performance framework, organizational values, and management best practices. Produces a prep sheet with suggested conversation topics, not a script.