God's eye view of your dev repos. Multi-project tracking across GitHub/Azure DevOps. AI learns from your commits to upgrade your agents.md.

Developer oversight and AI agent coaching. Use when viewing project status across repos, syncing GitHub data, or analyzing agents.md against commit patterns.

Security Scan

The skill's requirements and behavior match its description: it uses the GitHub CLI to read repos (local or remote), caches results in a local SQLite DB, and analyzes agent instruction files — nothing in the package indicates unexplained or unrelated access.

Purpose & Capability

Name/description align with the requested binaries (gh, sqlite3, jq) and the included scripts implement GitHub syncing, local file scanning, and agent-file analysis. Required tools match the stated functionality; no unrelated cloud credentials or services are requested.

Instruction Scope

Runtime instructions and scripts operate on repo data, local files, and GitHub via the gh CLI as described. The skill will read agent instruction files from local clones (if configured) or fetch them remotely via gh; it also writes snapshots and analysis results into ~/.god-mode. This is expected, but users should note it will read any paths they configure (local: entries) and will invoke gh which uses your existing authenticated session.

Install Mechanism

No install spec is declared for OpenClaw (instruction-only), and the included setup script runs locally. No remote binary downloads or third-party installers are invoked by the skill itself. The README suggests adding the scripts directory to PATH manually.

Credentials

No environment variables or external credentials are required by the skill; it delegates authentication to provider CLIs (gh/az/glab). That is proportional to its purpose. The only implicit credential exposure is via whatever access your installed gh/az/glab CLIs already have.

Persistence & Privilege

The skill writes data to ~/.god-mode and expects a config at ~/.config/god-mode/config.yaml. It does not request always:true and does not modify other skills. Users should be aware of persistent local storage of repo metadata and agent-file snapshots.

Assessment

What to check before installing: - This skill uses your existing gh/az/glab CLI auth: anything those CLIs can access is accessible to the skill when you run its commands (it does not store tokens itself). Only add projects you trust. - It will read files in any local paths you configure and will fetch file contents from repos via gh; do not point it at directories containing secrets or private materials you don't want copied into ~/.god-mode/cache.db. - The code builds SQL queries by string interpolation in several places; while the author attempts to escape single quotes for some fields, if you plan to expose this to untrusted inputs (e.g., adding project IDs from untrusted sources) review/validate inputs first. - Review the included scripts (they are present in the package) before running setup; setup will create ~/.god-mode and ~/.config/god-mode and may prompt to run an initial sync. - If you need stronger guarantees, run the scripts in a constrained environment or inspect the database contents after a sync to verify what was stored. Overall, the package appears coherent with its claimed purpose; treat it like any tool that uses your existing CLI authentication and stores local copies of repository metadata.

god-mode Skill

Developer oversight and AI agent coaching for OpenClaw.

Overview

god-mode gives you a bird's-eye view of all your coding projects and coaches you to write better AI agent instructions.

Key features:

• Multi-project status dashboard
• Incremental sync from GitHub (Azure/GitLab coming)
• Agent instruction analysis based on commit patterns
• Local SQLite cache for fast queries

Quick Start

# First-run setup
god setup

# Add a project
god projects add github:myuser/myrepo

# Sync data
god sync

# See overview
god status

# Analyze your agents.md
god agents analyze myrepo

Commands

god status [project]

Show overview of all projects, or details for one:

god status              # All projects
god status myproject    # One project in detail

god sync [project] [--force]

Fetch/update data from repositories:

god sync                # Incremental sync all
god sync myproject      # Just one project
god sync --force        # Full refresh (ignore cache)

god projects

Manage configured projects:

god projects                        # List all
god projects add github:user/repo   # Add project
god projects remove myproject       # Remove project

god agents analyze <project>

Analyze agents.md against commit history:

god agents analyze myproject

Finds gaps between your agent instructions and actual work patterns, suggests improvements.

god agents generate <project> (Coming Soon)

Bootstrap agents.md for a new project by analyzing repo structure.

Configuration

Config file: ~/.config/god-mode/config.yaml

projects:
  - id: github:user/repo
    name: My Project      # Display name
    priority: high        # high/medium/low
    tags: [work, api]
    local: ~/code/myrepo  # Local clone path

sync:
  initialDays: 90         # First sync lookback
  commitsCacheMinutes: 60

analysis:
  agentFiles:             # Files to search for
    - agents.md
    - AGENTS.md
    - CLAUDE.md
    - .github/copilot-instructions.md

Data Storage

All data stored locally in ~/.god-mode/:

• cache.db - SQLite database (commits, PRs, issues, analyses)
• contexts/ - Saved workspace contexts (v0.2)

Authentication

god-mode uses your existing CLI authentication:

Provider	CLI	Setup
GitHub	gh	gh auth login
Azure	az	az login
GitLab	glab	glab auth login

No tokens stored by god-mode. We delegate to CLIs you already trust.

Requirements

• gh - GitHub CLI (for GitHub repos)
• sqlite3 - Database
• jq - JSON processing

Examples

Morning Check-In

god status
# See all projects at a glance
# Notice any stale PRs or quiet projects

Before Switching Projects

god status myproject
# See recent activity, open PRs, issues
# Remember where you left off

Improving Your AI Assistant

god agents analyze myproject
# Get suggestions based on your actual commit patterns
# Apply recommendations to your agents.md

Weekly Review

god status
# Review activity across all projects
# Identify projects needing attention

Agent Workflows

Daily Briefing (Heartbeat)

# HEARTBEAT.md
- Run `god status` and summarize:
  - Projects with stale PRs (>3 days)
  - Projects with no activity (>5 days)
  - Open PRs needing review

Agent Analysis (Cron)

# Weekly agent instruction review
schedule: "0 9 * * 1"  # Monday 9am
task: |
  Run `god agents analyze` on high-priority projects.
  If gaps found, notify with suggestions.

Troubleshooting

"gh: command not found"

Install GitHub CLI: https://cli.github.com/

"Not logged in to GitHub"

Run: gh auth login

"No projects configured"

Add a project: god projects add github:user/repo

Stale data

Force refresh: god sync --force

---

OpenClaw Community Skill
License: MIT
Repository: https://github.com/InfantLab/god-mode-skill