feat: autoresearch-agent — bug fixes, plugin packaging, 5 slash commands

.claude-plugin/marketplace.json

@@ -4,11 +4,11 @@
     "name": "Alireza Rezvani",
     "url": "https://alirezarezvani.com"
   },
-  "description": "177 production-ready skill packages for Claude AI across 9 domains: marketing (43), engineering (24+25), C-level advisory (28), regulatory/QMS (12), product (12), project management (6), business growth (4), and finance (2). Includes 254 Python tools, 357 reference documents, 16 agents, and 17 slash commands.",
+  "description": "177 production-ready skill packages for Claude AI across 9 domains: marketing (43), engineering (24+25), C-level advisory (28), regulatory/QMS (12), product (12), project management (6), business growth (4), and finance (2). Includes 254 Python tools, 357 reference documents, 17 agents, and 22 slash commands.",
   "homepage": "https://github.com/alirezarezvani/claude-skills",
   "repository": "https://github.com/alirezarezvani/claude-skills",
   "metadata": {
-    "description": "177 production-ready skill packages across 9 domains with 254 Python tools, 357 reference documents, 16 agents, and 17 slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, and OpenClaw.",
+    "description": "177 production-ready skill packages across 9 domains with 254 Python tools, 357 reference documents, 17 agents, and 22 slash commands. Compatible with Claude Code, Codex CLI, Gemini CLI, and OpenClaw.",
     "version": "2.1.2"
   },
   "plugins": [
@@ -244,6 +244,25 @@
       ],
       "category": "development"
     },
+    {
+      "name": "autoresearch-agent",
+      "source": "./engineering/autoresearch-agent",
+      "description": "Autonomous experiment loop — optimize any file by a measurable metric. 5 slash commands (/ar:setup, /ar:run, /ar:loop, /ar:status, /ar:resume), 8 built-in evaluators, configurable loop intervals (10min to monthly).",
+      "version": "2.1.2",
+      "author": {
+        "name": "Alireza Rezvani"
+      },
+      "keywords": [
+        "autoresearch",
+        "optimization",
+        "experiments",
+        "benchmarks",
+        "loop",
+        "metrics",
+        "evaluators"
+      ],
+      "category": "development"
+    },
     {
       "name": "content-creator",
       "source": "./marketing-skill/content-creator",

.gemini/skills-index.json

@@ -1,8 +1,18 @@
 {
   "version": "1.0.0",
   "name": "gemini-cli-skills",
-  "total_skills": 218,
+  "total_skills": 229,
   "skills": [
+    {
+      "name": "README",
+      "category": "agent",
+      "description": "Agent from personas"
+    },
+    {
+      "name": "TEMPLATE",
+      "category": "agent",
+      "description": "One paragraph describing what this agent does, who it's for, and when to activate it."
+    },
     {
       "name": "cs-agile-product-owner",
       "category": "agent",
@@ -83,6 +93,21 @@
       "category": "agent",
       "description": "Google Workspace administration agent using the gws CLI. Orchestrates workspace setup, Gmail/Drive/Sheets/Calendar automation, security audits, and recipe execution. Spawn when users need Google Workspace automation, gws CLI help, or workspace administration."
     },
+    {
+      "name": "growth-marketer",
+      "category": "agent",
+      "description": "Growth marketing specialist for bootstrapped startups and indie hackers. Builds content engines, optimizes funnels, runs launch sequences, and finds scalable acquisition channels \u2014 all on a budget that makes enterprise marketers cry."
+    },
+    {
+      "name": "solo-founder",
+      "category": "agent",
+      "description": "Your co-founder who doesn't exist yet. Covers product, engineering, marketing, and strategy for one-person startups \u2014 because nobody's stopping you from making bad decisions and somebody should."
+    },
+    {
+      "name": "startup-cto",
+      "category": "agent",
+      "description": "Technical co-founder who's been through two startups and learned what actually matters. Makes architecture decisions, selects tech stacks, builds engineering culture, and prepares for technical due diligence \u2014 all while shipping fast with a small team."
+    },
     {
       "name": "business-growth-bundle",
       "category": "business-growth",
@@ -578,6 +603,11 @@
       "category": "engineering-advanced",
       "description": "API Test Suite Builder"
     },
+    {
+      "name": "autoresearch-agent",
+      "category": "engineering-advanced",
+      "description": "Autonomous experiment loop that optimizes any file by a measurable metric. Inspired by Karpathy's autoresearch. The agent edits a target file, runs a fixed evaluation, keeps improvements (git commit), discards failures (git reset), and loops indefinitely. Use when: user wants to optimize code speed, reduce bundle/image size, improve test pass rate, optimize prompts, improve content quality (headlines, copy, CTR), or run any measurable improvement loop. Requires: a target file, an evaluation command that outputs a metric, and a git repo."
+    },
     {
       "name": "changelog-generator",
       "category": "engineering-advanced",
@@ -628,6 +658,11 @@
       "category": "engineering-advanced",
       "description": "This skill should be used when the user asks to \"design interview processes\", \"create hiring pipelines\", \"calibrate interview loops\", \"generate interview questions\", \"design competency matrices\", \"analyze interviewer bias\", \"create scoring rubrics\", \"build question banks\", or \"optimize hiring systems\". Use for designing role-specific interview loops, competency assessments, and hiring calibration systems."
     },
+    {
+      "name": "loop",
+      "category": "engineering-advanced",
+      "description": "Start an autonomous experiment loop with user-selected interval (10min, 1h, daily, weekly, monthly). Uses CronCreate for scheduling."
+    },
     {
       "name": "mcp-server-builder",
       "category": "engineering-advanced",
@@ -668,6 +703,16 @@
       "category": "engineering-advanced",
       "description": "Release Manager"
     },
+    {
+      "name": "resume",
+      "category": "engineering-advanced",
+      "description": "Resume a paused experiment. Checkout the experiment branch, read results history, continue iterating."
+    },
+    {
+      "name": "run",
+      "category": "engineering-advanced",
+      "description": "Run a single experiment iteration. Edit the target file, evaluate, keep or discard."
+    },
     {
       "name": "runbook-generator",
       "category": "engineering-advanced",
@@ -678,6 +723,11 @@
       "category": "engineering-advanced",
       "description": "Skill from engineering/skill-tester/assets/sample-skill"
     },
+    {
+      "name": "setup",
+      "category": "engineering-advanced",
+      "description": "Set up a new autoresearch experiment interactively. Collects domain, target file, eval command, metric, direction, and evaluator."
+    },
     {
       "name": "skill-security-auditor",
       "category": "engineering-advanced",
@@ -688,6 +738,11 @@
       "category": "engineering-advanced",
       "description": "Skill Tester"
     },
+    {
+      "name": "skills-status",
+      "category": "engineering-advanced",
+      "description": "Show experiment dashboard with results, active loops, and progress."
+    },
     {
       "name": "tech-debt-tracker",
       "category": "engineering-advanced",
@@ -1096,7 +1151,7 @@
   ],
   "categories": {
     "agent": {
-      "count": 16,
+      "count": 21,
       "description": "Agent resources"
     },
     "business-growth": {
@@ -1116,7 +1171,7 @@
       "description": "Engineering resources"
     },
     "engineering-advanced": {
-      "count": 27,
+      "count": 33,
       "description": "Engineering-advanced resources"
     },
     "finance": {

.gemini/skills/autoresearch-agent/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/autoresearch-agent/SKILL.md

.gemini/skills/loop/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/autoresearch-agent/skills/loop/SKILL.md

.gemini/skills/resume/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/autoresearch-agent/skills/resume/SKILL.md

.gemini/skills/run/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/autoresearch-agent/skills/run/SKILL.md

.gemini/skills/setup/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/autoresearch-agent/skills/setup/SKILL.md

.gemini/skills/skills-status/SKILL.md

@@ -0,0 +1 @@
+../../../engineering/autoresearch-agent/skills/status/SKILL.md

CLAUDE.md

@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 This is a **comprehensive skills library** for Claude AI and Claude Code - reusable, production-ready skill packages that bundle domain expertise, best practices, analysis tools, and strategic frameworks. The repository provides modular skills that teams can download and use directly in their workflows.
 
-**Current Scope:** 177 production-ready skills across 9 domains with 254 Python automation tools, 357 reference guides, 16 agents, and 17 slash commands.
+**Current Scope:** 177 production-ready skills across 9 domains with 254 Python automation tools, 357 reference guides, 17 agents, and 22 slash commands.
 
 **Key Distinction**: This is NOT a traditional application. It's a library of skill packages meant to be extracted and deployed by users into their own Claude workflows.
 
@@ -37,7 +37,7 @@ This repository uses **modular documentation**. For domain-specific guidance, se
 claude-code-skills/
 ├── .claude-plugin/            # Plugin registry (marketplace.json)
 ├── agents/                    # 15 cs-* prefixed agents across all domains
-├── commands/                  # 17 slash commands (changelog, tdd, saas-health, workspace, prd, sprint-plan, etc.)
+├── commands/                  # 22 slash commands (changelog, tdd, saas-health, workspace, prd, sprint-plan, ar:*, etc.)
 ├── engineering-team/          # 24 core engineering skills + Playwright Pro + Self-Improving Agent
 ├── engineering/               # 25 POWERFUL-tier advanced skills
 ├── product-team/              # 12 product skills + Python tools
@@ -150,7 +150,7 @@ See [standards/git/git-workflow-standards.md](standards/git/git-workflow-standar
 
 **Phase 1-2 Complete:** 177 production-ready skills deployed across 9 domains
 - Engineering Core (24), Engineering POWERFUL (25), Product (8), Marketing (43), PM (6), C-Level (28), RA/QM (12), Business & Growth (4), Finance (2)
-- 254 Python automation tools, 357 reference guides, 16 agents, 17 commands
+- 254 Python automation tools, 357 reference guides, 17 agents, 22 commands
 - Complete enterprise coverage from engineering through regulatory compliance, sales, customer success, and finance
 - MkDocs Material docs site with 210+ indexed pages for SEO
 

README.md

@@ -1,16 +1,16 @@
 # Claude Code Skills & Plugins
 
-**177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools.**
+**177 production-ready skills, 17 agents, 3 personas, and an orchestration protocol for 11 AI coding tools.**
 
 Reusable expertise packages that give AI coding agents domain knowledge they don't have out of the box — from architecture and security to marketing, compliance, and C-level advisory.
 
 **Works with:** Claude Code · OpenAI Codex · Gemini CLI · OpenClaw · Cursor · Aider · Windsurf · Kilo Code · OpenCode · Augment · Antigravity
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge)](https://opensource.org/licenses/MIT)
 [![Skills](https://img.shields.io/badge/Skills-177-brightgreen?style=for-the-badge)](#skills-overview)
-[![Agents](https://img.shields.io/badge/Agents-16-blue?style=for-the-badge)](#agents)
+[![Agents](https://img.shields.io/badge/Agents-17-blue?style=for-the-badge)](#agents)
 [![Personas](https://img.shields.io/badge/Personas-3-purple?style=for-the-badge)](#personas)
-[![Commands](https://img.shields.io/badge/Commands-17-orange?style=for-the-badge)](#commands)
+[![Commands](https://img.shields.io/badge/Commands-22-orange?style=for-the-badge)](#commands)
 [![Stars](https://img.shields.io/github/stars/alirezarezvani/claude-skills?style=for-the-badge)](https://github.com/alirezarezvani/claude-skills/stargazers)
 [![SkillCheck Validated](https://img.shields.io/badge/SkillCheck-Validated-4c1?style=for-the-badge)](https://getskillcheck.com)
 

docs/agents/index.md

@@ -1,13 +1,13 @@
 ---
 title: "Agents"
-description: "All 16 Claude Code agents — multi-skill orchestrators across domains."
+description: "All 21 Claude Code agents — multi-skill orchestrators across domains."
 ---
 
 <div class="domain-header" markdown>
 
 # :material-robot: Agents
 
-<p class="domain-count">16 agents that orchestrate skills across domains</p>
+<p class="domain-count">21 agents that orchestrate skills across domains</p>
 
 </div>
 
@@ -67,6 +67,36 @@ description: "All 16 Claude Code agents — multi-skill orchestrators across dom
 
     Marketing
 
+-   :material-account:{ .lg .middle } **[Persona-Based Agents](readme.md)**
+
+    ---
+
+    Personas
+
+-   :material-account:{ .lg .middle } **[Agent Name Agent Personality](template.md)**
+
+    ---
+
+    Personas
+
+-   :material-account:{ .lg .middle } **[Growth Marketer Agent Personality](growth-marketer.md)**
+
+    ---
+
+    Personas
+
+-   :material-account:{ .lg .middle } **[Solo Founder Agent Personality](solo-founder.md)**
+
+    ---
+
+    Personas
+
+-   :material-account:{ .lg .middle } **[Startup CTO Agent Personality](startup-cto.md)**
+
+    ---
+
+    Personas
+
 -   :material-lightbulb-outline:{ .lg .middle } **[Agile Product Owner Agent](cs-agile-product-owner.md)**
 
     ---

docs/index.md

@@ -1,6 +1,6 @@
 ---
 title: Agent Skills for AI Coding Tools
-description: "177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools — Claude Code, OpenAI Codex, Gemini CLI, Cursor, Aider, Windsurf, and more."
+description: "177 production-ready skills, 17 agents, 3 personas, and an orchestration protocol for 11 AI coding tools — Claude Code, OpenAI Codex, Gemini CLI, Cursor, Aider, Windsurf, and more."
 hide:
   - toc
   - edit
@@ -14,7 +14,7 @@ hide:
 
 # Agent Skills
 
-177 production-ready skills, 16 agents, 3 personas, and an orchestration protocol for AI coding tools.
+177 production-ready skills, 17 agents, 3 personas, and an orchestration protocol for AI coding tools.
 { .hero-subtitle }
 
 [Get Started](getting-started.md){ .md-button .md-button--primary }