AI-Firstify

SkillMedia

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the AI-Firstify skill

What this skill tells your AI

The instructions your AI receives, as published by techwolf-ai/ai-first-toolkit in plugins/ai-firstify/skills/ai-firstify/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars
99
Forks
3
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
ai-firstify
Source
github.com/techwolf-ai/ai-first-toolkit