npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@le2004/agentspec

v1.0.1

Published

AgentSpec for Gemini CLI: spec-driven data engineering workflows, agents, commands, and KB domains.

Downloads

225

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

le2004le2004

Keywords

gemini-clidata-engineeringsddspec-driven-developmentdbtsparkairflowlakehouse

Readme

AgentSpec

Spec-driven data engineering workflows for Gemini CLI.

AgentSpec installs a project-local runtime with specialist role profiles, knowledge base domains, SDD templates, and Gemini custom commands for building data engineering work through repeatable phases.

Install

npm install -g @le2004/agentspec

Initialize AgentSpec inside a project:

agentspec init

Then open Gemini CLI in that project and use the generated commands:

/agentspec:brainstorm
/agentspec:define
/agentspec:design
/agentspec:build
/agentspec:ship

What Init Creates

.gemini/
  commands/
    agentspec/
.agentspec/
  agents/
  commands/
  kb/
  scripts/
  sdd/
  skills/
GEMINI.md

Commands

Workflow:

  • /agentspec:brainstorm
  • /agentspec:define
  • /agentspec:design
  • /agentspec:build
  • /agentspec:ship
  • /agentspec:iterate

Data engineering:

  • /agentspec:pipeline
  • /agentspec:schema
  • /agentspec:data-quality
  • /agentspec:sql-review
  • /agentspec:lakehouse
  • /agentspec:ai-pipeline
  • /agentspec:data-contract

Utilities:

  • /agentspec:review
  • /agentspec:judge
  • /agentspec:status
  • /agentspec:generate-web-diagram
  • /agentspec:generate-slides

CLI

agentspec init --dry-run
agentspec init --force
agentspec validate
agentspec doctor

Gemini Extension Conflicts

Use only one AgentSpec command source at a time.

The npm package is designed to generate workspace commands in:

.gemini/commands/agentspec/

If you also have an AgentSpec Gemini extension installed at ~/.gemini/extensions/agentspec, Gemini CLI will detect duplicate commands and rename them, for example:

/agentspec:build -> /agentspec:agentspec:build
/agentspec:build -> /workspace.agentspec:build

Fix it by moving the extension out of the way:

mv ~/.gemini/extensions/agentspec ~/.gemini/extensions/agentspec.bak
agentspec init --force

Then restart Gemini CLI.

Runtime Model

AgentSpec for Gemini CLI uses role profiles and routing instructions rather than plugin-native subagents. The generated GEMINI.md tells Gemini where to find:

  • specialist profiles in .agentspec/agents/
  • command source docs in .agentspec/commands/
  • KB domains in .agentspec/kb/
  • routing instructions in .agentspec/skills/agent-router/
  • SDD artifacts in .agentspec/sdd/

Context7

Context7 MCP is not installed or configured by AgentSpec. During the Gemini refactor, maintainers use Context7 only to verify current external documentation.

Development

npm run check
npm run smoke:init

The current transition keeps legacy repository assets in place while the npm package publishes only the Gemini CLI runtime under templates/agentspec/.

License

MIT