extension-architect

Scaffold and validate Gemini CLI extensions with standardized manifests.

2|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/bl1nk-bot/agent-library --skill extension-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extension-architect
Source: https://github.com/bl1nk-bot/agent-library/tree/main/.gemini/skills/extension-architect
Command: npx skills add https://github.com/bl1nk-bot/agent-library --skill extension-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides an automated way to scaffold Gemini CLI extensions and verify their structure and compliance, saving time and reducing setup errors.

Core Features & Use Cases

  • Scaffold New Extensions: Create folder structures, initial manifest, and core files for a Gemini CLI extension.
  • Validate Extensions: Check for missing manifests, invalid JSON, and adherence to Gemini extension guidelines.
  • Reference Guidelines: Consult official documentation to resolve questions about gemini-extension.json schema and best practices.

Quick Start

Use the extension-architect skill to initialize a new Gemini extension with a starter structure and manifest.

  • Command: /ext:init <name> --skill extension-architect
  • Direct Script: python {{skill_path}}/scripts/init_extension.py <name> --skill extension-architect

Frequently Asked Questions about extension-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new Gemini CLI extension?

To scaffold a Gemini CLI extension, use the initialization script to create a standardized project layout, core files, and a starter gemini-extension.json manifest. This ensures a correct folder structure and baseline configuration.

What is the best way to validate a gemini-extension.json manifest?

Validating a gemini-extension.json manifest involves checking for missing files, invalid JSON syntax, and adherence to Gemini extension guidelines. The validation script automates these checks to verify manifest correctness across projects.

How does extension scaffolding work for Gemini CLI dev-tools?

Extension scaffolding for Gemini CLI dev-tools works by automatically generating the required folder structures and a gemini-extension.json manifest. This enforces best practices and reduces manual setup errors for extension authors.

Do I need to manually create the project layout for a Gemini extension?

You do not need to manually create the project layout for a Gemini extension. The scaffolding script initializes the folder structure and manifest automatically, enforcing a standardized layout across your projects.

Can I check my Gemini extension for missing manifests and invalid JSON?

You can check your Gemini extension for missing manifests and invalid JSON by running the validation script. It verifies structural compliance and checks the gemini-extension.json schema against official guidelines.

Why does my Gemini CLI extension fail validation checks?

Gemini CLI extension validation fails when the gemini-extension.json manifest is missing, contains invalid JSON, or violates official schema guidelines. Use the validation script to identify and resolve these structural compliance issues.