steroid-scan

Scan codebases to detect tech stack and generate a context.md snapshot.

3|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/nzkbuild/steroid-workflow --skill steroid-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: steroid-scan
Source: https://github.com/nzkbuild/steroid-workflow/tree/main/skills/steroid-scan
Command: npx skills add https://github.com/nzkbuild/steroid-workflow --skill steroid-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides AI coding assistants with a comprehensive understanding of the existing codebase before development begins, preventing conflicts, duplicated logic, and architectural mismatches.

Core Features & Use Cases

  • Tech Stack Detection: Identifies languages, frameworks, and dependencies.
  • Project Structure Mapping: Visualizes the file hierarchy and key directories.
  • Pattern & Test Infrastructure Discovery: Uncovers existing conventions and testing setups.
  • Use Case: Before an AI starts building a new feature, this skill scans the project to understand its current technologies and structure, ensuring the AI's proposed code integrates seamlessly.

Quick Start

Run the steroid scan skill to analyze the current project's codebase.

Frequently Asked Questions about steroid-scan

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

FAQPage Schema
How do I give an AI coding assistant codebase awareness before generating new features?

To give an AI codebase awareness, you need to scan the project to detect the tech stack, map the project structure, and identify existing patterns. This process generates a context.md snapshot that informs the AI and prevents architectural mismatches.

What is the best way to analyze an existing codebase for tech stack and test infrastructure?

Analyzing a codebase for its tech stack and test infrastructure involves scanning the project files to identify languages, frameworks, dependencies, and testing setups. This uncovers existing conventions and visualizes the file hierarchy for downstream AI phases.

Can I enforce command execution and establish AI guardrails during code scanning?

You can enforce command execution during code scanning by using a Node.js circuit breaker. This mechanism establishes AI guardrails to ensure the scanning process runs safely and captures an accurate snapshot of the codebase.

How does project structure mapping prevent duplicated logic when using AI to write code?

Project structure mapping prevents duplicated logic by visualizing the file hierarchy and key directories before development begins. By providing this codebase context, the AI understands existing patterns and integrates proposed code seamlessly without conflicts.

Do I need to generate a context snapshot before starting TDD with an AI assistant?

Generating a context snapshot before starting TDD is highly recommended to uncover existing test infrastructure and conventions. This ensures the AI proposes test-driven development code that aligns with the current project structure and testing setups.