Overview

The gemkit-kits-starter is the official entry point for new GemKit users. It provides a balanced set of agents and skills that cover the majority of daily development tasks.

Agents

The Starter Kit includes three primary agents:

Agent	Description
code-executor	Implements features using plan and test-driven methodology
researcher	Conducts multi-step technical investigations with source verification
planner	research, analyze, and create comprehensive implementation plans for new features, system architectures, or complex technical solutions
tester	Generates tests and evaluates coverage comprehensively

Extensions

Six specialized skills are included:

Extension	Description
spawn-agent	Locates optimal agent-skill pairings via BM25 search
frontend-development	React 19, TanStack Query/Router, MUI v7, Zustand, Vitest
backend-development	Node.js, Python, APIs, OAuth 2.1, PostgreSQL, security
frontend-design	Modern CSS, animations, distinctive UI/UX aesthetics
testing	Vitest, Jest, Playwright, MSW, coverage analysis
research	Technical investigation with validation and reporting
planning	Create detailed implementation plans from raw input (research reports, feature requests, requirements)

Slash Commands

Three commands are available:

Command	Description
`/code`	Executes coding and testing workflows from existing plans
`/cook`	Implement a feature [step by step]
`/test`	Runs local tests and provides summary analysis
`/paste/image`	Analyzes images from clipboard
`/paste/video`	Analyzes videos from clipboard

Hooks

Session lifecycle hooks included:

Hook	Triggers	Function
gk-session-init	SessionStart, BeforeAgent, BeforeModel	Initializes or resumes sessions
gk-session-end	SessionEnd	Tracks completion and metrics
gk-scout-block	Tool calls	Restricts access to .gkignore directories
gk-dev-rules-reminder	BeforeAgent	Injects rules and context

Directory Structure

When you initialize a project with the Starter Kit, it creates the following structure:

text

.gemini/
├── agents/
│   ├── code-executor.md
│   ├── researcher.md
│   ├── planner.md
│   └── tester.md
├── commands/
│   ├── code.toml
│   ├── cook.toml
│   ├── test.toml
│   └── paste/
│       ├── image.toml
│       └── video.toml
├── extensions/
│   ├── spawn-agent/
│   ├── frontend-development/
│   ├── backend-development/
│   ├── frontend-design/
│   ├── testing/
│   ├── planning/
│   └── research/
├── hooks/
│   ├── gk-session-init.cjs
│   ├── gk-session-end.cjs
│   ├── gk-scout-block.cjs
│   ├── gk-dev-rules-reminder.cjs
│   └── lib/
└── .env

settings.json
.gk.json
.gkignore

Getting Started

To create a new project with the Starter Kit:

bash

gk new my-project

Or initialize in an existing project: