{"id":51569403,"url":"https://github.com/bthavanish/demiurge","last_synced_at":"2026-07-10T18:02:42.450Z","repository":{"id":369381881,"uuid":"1289103813","full_name":"bthavanish/demiurge","owner":"bthavanish","description":"Demiurge is an all-in-one AI skill that acts like a senior developer. It uses one strict rulebook to build secure apps from the ground up or completely fix broken ones.","archived":false,"fork":false,"pushed_at":"2026-07-05T02:15:40.000Z","size":1100,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-05T03:13:54.465Z","etag":null,"topics":["agent","ai","caveman","claude","coding","demiurge","high-level","humanizer","impeccable","low-level","master-skill","material-3","mulit-skills","opencode","security","skills","trail-of-bits","ui","webdev"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bthavanish.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-04T10:50:05.000Z","updated_at":"2026-07-05T02:15:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bthavanish/demiurge","commit_stats":null,"previous_names":["bthavanish/demiurge"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bthavanish/demiurge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bthavanish%2Fdemiurge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bthavanish%2Fdemiurge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bthavanish%2Fdemiurge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bthavanish%2Fdemiurge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bthavanish","download_url":"https://codeload.github.com/bthavanish/demiurge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bthavanish%2Fdemiurge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35338653,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-10T02:00:06.465Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai","caveman","claude","coding","demiurge","high-level","humanizer","impeccable","low-level","master-skill","material-3","mulit-skills","opencode","security","skills","trail-of-bits","ui","webdev"],"created_at":"2026-07-10T18:02:41.665Z","updated_at":"2026-07-10T18:02:42.445Z","avatar_url":"https://github.com/bthavanish.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# DEMIURGE\n\n\u003cimg src=\"assets/demiurge.png\" width=\"300\" alt=\"demiurge\"\u003e\n\nAll-in-one skill for building, auditing, critiquing, and hardening code.\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n\u003c/div\u003e\n\n## About\n\nDemiurge is an AI coding skill that combines five disciplines into one workflow: lazy problem-solving (ponytail), terse output (caveman), human-sounding code (humanizer), frontend design sense, and strict coding standards. It works with TypeScript, JavaScript, C, C++, Python, Rust, Go, Java, Kotlin, Swift, Dart, HTML, CSS, and more.\n\nIt auto-detects what you want to do from natural language. Say what you need and it figures out the right approach.\n\n## Installation\n\n### Skills CLI (Recommended)\n\n```bash\nnpx skills add bthavanish/demiurge\n```\n\n### Claude Code\n\n```bash\n/plugin marketplace add bthavanish/demiurge\n/plugin install demiurge@demiurge\n```\n\n### Manual\n\nClone this repo and copy `skill/` into your agent's skills directory.\n\n## Usage\n\n```\n/demiurge [mode] [target]\n```\n\nNo mode needed. Type what you want:\n\n```bash\n/demiurge                              # full audit + ask which fixes to apply\n/demiurge fix the security issues in my api   # context-gather for auth, fix it\n/demiurge clean up this frontend code          # context-gather, humanize it\n/demiurge make a settings page                 # build it\n/demiurge what can I delete from this repo     # debt mode\n```\n\nGive an exact task and it context-gathers for that change. No context and it runs a full audit.\n\n**UI guard:** UI references only load for apps with a UI. Backend/CLI/library apps skip UI modes automatically.\n\n### Build\n\n| Mode | Command | Description |\n|------|---------|-------------|\n| `make` | `/demiurge make [feature]` | Builds on user instructions using ponytail ladder + coding standards. |\n| `design-material` | `/demiurge design-material [target]` | Material Design 3 builder. Explicit only, UI apps only. |\n\n### Evaluate\n\n| Mode | Command | Description |\n|------|---------|-------------|\n| `audit` | `/demiurge audit [target]` | Full codebase audit. Security, logic, dead code, style, architecture. |\n| `audit-frontend` | `/demiurge audit-frontend [target]` | Frontend/UI/UX audit. Design tokens, a11y, responsive, anti-patterns. UI apps only. |\n| `audit-backend` | `/demiurge audit-backend [target]` | Backend/logic/security audit. Injection, auth, error handling, type safety. |\n| `critique` | `/demiurge critique [target]` | UX design review. Nielsen heuristics (/40), cognitive load, personas. UI apps only. |\n| `review` | `/demiurge review [target]` | One-line code review. Severity-tagged: bug, risk, nit, q. |\n\n### Refine\n\n| Mode | Command | Description |\n|------|---------|-------------|\n| `secure-code` | `/demiurge secure-code [target]` | Fixes bugs, vulnerabilities, logic errors, dead code directly. |\n| `humanize` | `/demiurge humanize [target]` | Detects AI patterns in code and rewrites to sound human. |\n| `polish` | `/demiurge polish [target]` | Final quality pass. Typography, spacing, color, motion, copy. UI apps only. |\n| `harden` | `/demiurge harden [target]` | Production-readiness. Error handling, i18n, edge cases. |\n| `bolder` | `/demiurge bolder [target]` | Amplifies bland designs. More decisive and committed. UI apps only. |\n| `quieter` | `/demiurge quieter [target]` | Tones down aggressive or overstimulating designs. UI apps only. |\n\n### Manage\n\n| Mode | Command | Description |\n|------|---------|-------------|\n| `debt` | `/demiurge debt [target]` | Harvests `ponytail:` comment markers into a debt ledger. |\n| `compress` | `/demiurge compress [filepath]` | Compresses natural language files to save tokens. |\n| `commit` | `/demiurge commit` | Generates terse conventional commit messages. |\n\n### Docs\n\n| Mode | Command | Description |\n|------|---------|-------------|\n| `docs` | `/demiurge docs [target]` | Writes or restructures documentation using Diataxis framework. |\n| `readme` | `/demiurge readme [target]` | Creates or improves README files with audience-specific templates. |\n| `prose` | `/demiurge prose [target]` | Edits machine-generated prose to remove AI writing tropes. |\n\n## Base Rules\n\nEvery mode applies these rules:\n\n- **Ponytail ladder** -- simplest solution first. YAGNI. Reuse before building.\n- **Caveman output** -- terse output, full accuracy. Code blocks preserved verbatim.\n- **Humanizer** -- no AI slop in code or prose. No em dashes, no rule-of-three, no AI vocabulary.\n- **Coding standards** -- KISS, SRP, descriptive names, no magic numbers, immutability, portable, no hallucinations.\n- **Comment standards** -- why not what, no dead code, no metadata, ponytail markers for shortcuts.\n- **DESIGN.md enforcement** -- follow the design system if one exists.\n- **Modularity** -- small, cohesive, loosely coupled functions. Dependencies flow one direction.\n- **No hardcoding** -- env vars, config files, constants, parameters.\n- **Always ask before fixing.** Never auto-fix without presenting findings and getting user confirmation.\n\n## Supported Agents\n\nDemiurge works with multiple AI coding agents through adapter directories:\n\n| Agent | Adapter Directory |\n|-------|-------------------|\n| Claude Code | `.claude/skills/demiurge/` |\n| OpenCode | `.opencode/skills/demiurge/` |\n| Cursor | `.cursor/skills/demiurge/` |\n| Gemini | `.gemini/skills/demiurge/` |\n| Kiro | `.kiro/skills/demiurge/` |\n| Trae | `.trae/skills/demiurge/` |\n| Trae CN | `.trae-cn/skills/demiurge/` |\n| Pi | `.pi/skills/demiurge/` |\n| Qoder | `.qoder/skills/demiurge/` |\n| Rovo Dev | `.rovodev/skills/demiurge/` |\n| Generic | `.agents/skills/demiurge/` |\n| Codex | `.codex/skills/demiurge/` |\n\n## Credits\n\nBuilt on work from the security and developer tools community.\n\n### Core Skills\n\n| Skill | Author | Repository |\n|-------|--------|------------|\n| **caveman** | Julius Brussee | [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman) |\n| **humanizer** | blader | [blader/humanizer](https://github.com/blader/humanizer) |\n| **impeccable** | pbakaus | [pbakaus/impeccable](https://github.com/pbakaus/impeccable) |\n| **ponytail** | Dietrich Gebert | [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) |\n| **material-3-skill** | hamen | [hamen/material-3-skill](https://github.com/hamen/material-3-skill) |\n| **maintainable-typescript \u0026 write-good-docs** | miguelspizza | [miguelspizza/skills](https://github.com/miguelspizza/skills) |\n\n### Security and Analysis\n\n40 skills from the [Trail of Bits skills collection](https://github.com/trailofbits/skills). Security audit methodologies, vulnerability patterns, and analysis techniques.\n\n### Additional References\n\n| Source | What We Took |\n|--------|--------------|\n| [Trail of Bits Testing Handbook](https://appsec.guide) | Security testing methodologies, tool configurations, vulnerability detection techniques |\n| [Wikipedia: Signs of AI Writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) | 33 AI writing patterns for the humanizer skill |\n\n## License\n\nMIT. Copyright 2026 Thavanish brijesh.\n\nThird-party references are used under their respective licenses. See individual repositories for details. Most Trail of Bits skills use the [MIT License](https://github.com/trailofbits/skills/blob/main/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbthavanish%2Fdemiurge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbthavanish%2Fdemiurge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbthavanish%2Fdemiurge/lists"}