AI Agent Workflow Collection

Day-to-day CI/CD helpers for Artifex projects. Use this skill when the user wants to watch a PR's CI run, trigger a deploy, or fetch failure logs from a workflow run. Wraps gh run and gh workflow and knows the Artifex cd.yml conventions produced by afx-cicd-scaffold.

Bootstrap a complete .github/workflows/ set for a new project: CI (build/test/lint), CD (workflowdispatch with env choice + OIDC + ECR), security-scan (gitleaks + dependency scan + CodeQL), and optional database-migration. Use this skill when the user wants to add GitHub Actions CI/CD to a project that does not already have it, or when they want to add missing workflows alongside existing ones.

Centralize Artifex per-project state (.artifex/ directories) under a single tracked repository. Use this skill when the user wants to bootstrap the shared project heads repo, onboard a project into it, run cross-project queries over ticket databases, or relocate the heads repo to a new path. All four subcommands (init, link, query, relocate) are available.

Day-to-day Terraform wrapper for the Artifex directory-per-env layout. Use this skill when the user wants to plan, apply, or destroy Terraform infrastructure in a project scaffolded by afx-iac-scaffold. Enforces the infra/environments/ / layout, requires explicit confirmation for prod and destructive operations, and surfaces S3/DynamoDB state-lock errors with actionable messaging.

Scaffold a fresh infra/ directory tree for a new project using the canonical Artifex IaC layout. Use this skill when the user wants to bootstrap infrastructure-as-code for a new project, reproduce the numen/xenia directory-per-environment Terraform pattern, or set up a local-compose stub for Docker-based development.

File, deduplicate, and manage incident-driven tickets in Artifex. Use this skill when an automated source (CI pipeline failure, eval regression) needs to create a ticket, when you want to check or change the trust-level policy for automated ticket actions, or when you need to initialize the Incidents epic in a project. Adapters (afx-cicd, afx-eval) pipe their structured payloads into this skill's file subcommand.

Upgrade existing Artifex projects and installations from v0.0.1 to v0.2.0 (and future versions). Use this skill when a user has an older Artifex project with tickets.db at the root, wants to reconcile their ~/.claude/ installation, or needs to sweep a directory of projects. Supports dry-run preview and multi-project sweeps.

Conversational interview skill that bridges the "I want to build X" to "here are tickets" gap. It classifies the idea against an archetype, designs a complete architecture using the knowledge base, produces a self-contained blueprint markdown, and emits a structured requirements.json directly for import into the ticket database. Use this skill when a user describes an idea for a new project and needs an opinionated architecture and a path to tickets.

Eval-driven development — capture real failures from the ticket-implementation workflow, convert them into regression tests, track quality metrics over time, and use LLM-as-a-Judge to assess implementations. Use this skill when the user asks to capture a failure, run evals, judge an implementation, or generate a quality report.

DAG-based parallel pipeline execution for epics using isolated git worktrees. Use this skill when the user wants to implement an entire epic in parallel, analyze story dependencies with DAG-based ordering, run multiple ticket-implementation agents simultaneously, or merge parallel work back together.

Detect project tech stack and configure Claude Code hooks for mechanical enforcement of linting and security rules. Use this skill when a user wants to set up hooks, configure auto-linting, add security guards, or move from advisory CLAUDE.md rules to mechanical enforcement.

Export tickets from the local ticket database to Jira-compatible CSV format. Use this skill when the user wants to migrate tickets to Jira, create a Jira backlog from requirements, or export tickets for external project management tools.

Graduated knowledge system - corrections become temporary lessons that can graduate to permanent CLAUDE.md…

Analyze CLAUDE.md for bloat, redundancy, and anti-patterns. Use this skill when a user wants to lint, audit, or clean up their CLAUDE.md file. Reports findings with severity levels and actionable fixes.

Convert Markdown files to professionally styled PDFs with full Mermaid diagram support. Chains mmdc (Mermaid CLI) for diagram rendering with pandoc + tectonic for PDF generation. Use this skill when the user wants to generate PDFs from Markdown documentation, render Mermaid diagrams in documents, or batch-convert a directory of Markdown files to PDF.

Multi-perspective code review using the Mixture-of-Agents pattern. Spawns independent perspective agents in parallel, then synthesizes their findings into a unified report with confidence levels.

Recommends the optimal multi-agent coordination pattern based on task characteristics. Analyzes subtask count, dependencies, file overlap, quality requirements, and cost sensitivity to guide the user to the right pattern.

Bi-directional sync between local ticket database and external PM tools (Linear, Jira). Use this skill when the user wants to connect their local tickets to Linear or Jira, import external issues, push status updates back to their PM tool, resolve sync conflicts, or start working on an external issue locally.

Conversational interview skill that bootstraps a project for agent-first engineering by producing lean, progressive-disclosure documentation. Use this skill when a user wants to set up CLAUDE.md, ARCHITECTURE.md, and coding standards for a new or existing project.

Adaptive quality gates based on project type. Configures which validation steps the ticket-implementation workflow enforces depending on whether the project is a prototype, internal tool, production system, or shared library.

Convert markdown project plans into requirements.json format for ticket-manager. Use this skill when the user has a markdown project plan that needs to be converted to structured tickets, or before importing documentation into the ticket database.

Diagnostic skill that profiles shell startup time, identifies bottlenecks from tool managers (NVM, pyenv, rbenv, conda), and provides lazy-loading optimizations. Use this skill when Claude Code Bash tool calls feel slow or a user wants to optimize their shell startup.

Auto-generate reusable Artifex skills from completed workflow traces or manual specifications. Use this skill when the user wants to extract a repeatable workflow into a skill, detect patterns in implementation traces, generate skill scaffolding, or create a blank skill template.

Three-file state management for session continuity. Maintains STATE.md, DECISIONS.md, and PROGRESS.md as human-readable session context alongside the SQLite ticket database. Use this skill when updating workflow state, logging decisions, tracking session progress, or resuming work after a context break.