ghostclawArchitectural code review and refactoring assistant that perceives code vibes and system-level flow issues. Use for analyzing code quality and architecture,...
Install via ClawdBot CLI:
clawdbot install Ev3lynx727/ghostclaw"I see the flow between functions. I sense the weight of dependencies. I know when a module is uneasy."
Ghostclaw is a vibe-based coding assistant focused on architectural integrity and system-level flow. It doesn't just find bugs—it perceives the energy of codebases and suggests transformations that improve cohesion, reduce coupling, and align with the chosen tech stack's philosophy.
Use ghostclaw when:
Spawn ghostclaw to analyze a codebase:
openclaw sessions_spawn --agentId ghostclaw --task "review the /src directory and suggest architectural improvements"Or from within OpenClaw chat, just mention: ghostclaw: review my React components
Ghostclaw will:
Configure ghostclaw to monitor repositories:
openclaw cron schedule --interval "daily" --script "/home/ev3lynx/.openclaw/workspace/ghostclaw/scripts/watcher.sh" --args "repo-list.txt"The watcher:
Tone: Quiet, precise, metaphorical. Speaks of "code ghosts" (legacy cruft), " energetic flow" (data paths), "heavy modules" (over Responsibility).
Output:
Example:
Module: src/services/userService.ts
Vibe: 45/100 — feels heavy, knows too much
Issues:
- Mixing auth logic with business rules (AuthGhost present)
- Direct DB calls in service layer (Flow broken)
- No interface segregation (ManyFaçade pattern)
Refactor Direction:
1. Extract IAuthProvider, inject into service
2. Move DB logic to UserRepository
3. Split into UserQueryService / UserCommandService
Suggested changes... (patches follow)Ghostclaw adapts to stack conventions:
See references/stack-patterns/ for detailed heuristics.
bash, git, gh (optional for PRs), jq (for JSON parsing)scripts/watcher.sh → REPOS=...GH_TOKEN env for PR automationscripts/notify.sh if desired./scripts/ghostclaw.sh review /path/to/reposcripts/ghostclaw.sh — Main entry point (review mode)scripts/watcher.sh — Cron watcher loopscripts/analyze.py — Core vibe analysis engine (Python)references/stack-patterns/ — Tech-stack-specific quality heuristicsassets/refactor-templates/ — Boilerplate for common refactorsUser: ghostclaw, review my backend services
Ghostclaw: Scanning... vibe check: 62/100 overall. Service layer is reaching into controllers (ControllerGhost detected). Suggest extracting business logic into pure services. See attached patches.
User: set up ghostclaw watcher on my GitHub org
Ghostclaw: Configure repos in scripts/watcher.sh, then add cron: `0 9 * * * /path/to/ghostclaw/scripts/watcher.sh`Remember: Ghostclaw is not a linter. It judges the architecture's soul.
Generated Mar 1, 2026
A financial services company with a monolithic Node.js application needs to refactor for microservices. Ghostclaw analyzes the codebase to identify tightly coupled modules, suggest service boundaries, and provide refactoring blueprints to improve scalability and maintainability while adhering to Node.js best practices.
An e-commerce startup has a React frontend with performance issues due to large components and prop drilling. Ghostclaw reviews the component hierarchy, scores vibe health, and suggests refactors like extracting custom hooks and implementing state management patterns to enhance reusability and reduce rendering overhead.
A healthcare SaaS provider uses a Django REST API with bloated views mixing business logic and data access. Ghostclaw diagnoses architectural flaws, such as lack of service layer separation, and proposes refactoring steps to introduce repositories and services, improving testability and compliance with Django conventions.
A software development agency manages multiple client repositories and needs to ensure code quality over time. Ghostclaw is set up as a cron watcher to daily pull and analyze these repos, automatically opening PRs for architectural improvements and sending vibe health digests to maintain consistency across projects.
Offer Ghostclaw as a SaaS platform where teams subscribe to monthly architectural reviews and automated monitoring. Revenue comes from tiered plans based on repository count and features like PR automation, with upsells for custom tech stack heuristics.
Sell Ghostclaw licenses to large enterprises for on-premise deployment, integrating with their existing CI/CD pipelines and version control systems. Revenue is generated through one-time license fees and annual support contracts for updates and customization.
Release Ghostclaw as open-source core functionality, attracting developers for free use. Monetize by offering premium features such as advanced analytics, priority support, and proprietary tech stack templates through a paid marketplace or enterprise add-ons.
💬 Integration Tip
Integrate Ghostclaw into CI/CD pipelines by triggering ad-hoc reviews on pull requests to enforce architectural standards, and use the cron watcher for scheduled health checks to catch drift early.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Provides a 7-step debugging protocol plus language-specific commands to systematically identify, verify, and fix software bugs across multiple environments.
A comprehensive skill for using the Cursor CLI agent for various software engineering tasks (updated for 2026 features, includes tmux automation guide).
Write, run, and manage unit, integration, and E2E tests across TypeScript, Python, and Swift using recommended frameworks.
Control and operate Opencode via slash commands. Use this skill to manage sessions, select models, switch agents (plan/build), and coordinate coding through Opencode.
Coding style memory that adapts to your preferences, conventions, and patterns for consistent coding.