252d68fd45
* docs: deep audit — fix stale config keys, missing commands, and registry drift Cross-checked ~80 high-impact docs pages (getting-started, reference, top-level user-guide, user-guide/features) against the live registries: hermes_cli/commands.py COMMAND_REGISTRY (slash commands) hermes_cli/auth.py PROVIDER_REGISTRY (providers) hermes_cli/config.py DEFAULT_CONFIG (config keys) toolsets.py TOOLSETS (toolsets) tools/registry.py get_all_tool_names() (tools) python -m hermes_cli.main <subcmd> --help (CLI args) reference/ - cli-commands.md: drop duplicate hermes fallback row + duplicate section, add stepfun/lmstudio to --provider enum, expand auth/mcp/curator subcommand lists to match --help output (status/logout/spotify, login, archive/prune/ list-archived). - slash-commands.md: add missing /sessions and /reload-skills entries + correct the cross-platform Notes line. - tools-reference.md: drop bogus '68 tools' headline, drop fictional 'browser-cdp toolset' (these tools live in 'browser' and are runtime-gated), add missing 'kanban' and 'video' toolset sections, fix MCP example to use the real mcp_<server>_<tool> prefix. - toolsets-reference.md: list browser_cdp/browser_dialog inside the 'browser' row, add missing 'kanban' and 'video' toolset rows, drop the stale '38 tools' count for hermes-cli. - profile-commands.md: add missing install/update/info subcommands, document fish completion. - environment-variables.md: dedupe GMI_API_KEY/GMI_BASE_URL rows (kept the one with the correct gmi-serving.com default). - faq.md: Anthropic/Google/OpenAI examples — direct providers exist (not just via OpenRouter), refresh the OpenAI model list. getting-started/ - installation.md: PortableGit (not MinGit) is what the Windows installer fetches; document the 32-bit MinGit fallback. - installation.md / termux.md: installer prefers .[termux-all] then falls back to .[termux]. - nix-setup.md: Python 3.12 (not 3.11), Node.js 22 (not 20); fix invalid 'nix flake update --flake' invocation. - updating.md: 'hermes backup restore --state pre-update' doesn't exist — point at the snapshot/quick-snapshot flow; correct config key 'updates.pre_update_backup' (was 'update.backup'). user-guide/ - configuration.md: api_max_retries default 3 (not 2); display.runtime_footer is the real key (not display.runtime_metadata_footer); checkpoints defaults enabled=false / max_snapshots=20 (not true / 50). - configuring-models.md: 'hermes model list' / 'hermes model set ...' don't exist — hermes model is interactive only. - tui.md: busy_indicator -> tui_status_indicator with values kaomoji|emoji|unicode|ascii (not kawaii|minimal|dots|wings|none). - security.md: SSH backend keys (TERMINAL_SSH_HOST/USER/KEY) live in .env, not config.yaml. - windows-wsl-quickstart.md: there is no 'hermes api' subcommand — the OpenAI-compatible API server runs inside hermes gateway. user-guide/features/ - computer-use.md: approvals.mode (not security.approval_level); fix broken ./browser-use.md link to ./browser.md. - fallback-providers.md: top-level fallback_providers (not model.fallback_providers); the picker is subcommand-based, not modal. - api-server.md: API_SERVER_* are env vars — write to per-profile .env, not 'hermes config set' which targets YAML. - web-search.md: drop web_crawl as a registered tool (it isn't); deep-crawl modes are exposed through web_extract. - kanban.md: failure_limit default is 2, not '~5'. - plugins.md: drop hard-coded '33 providers' count. - honcho.md: fix unclosed quote in echo HONCHO_API_KEY snippet; document that 'hermes honcho' subcommand is gated on memory.provider=honcho; reconcile subcommand list with actual --help output. - memory-providers.md: legacy 'hermes honcho setup' redirect documented. Verified via 'npm run build' — site builds cleanly; broken-link count went from 149 to 146 (no regressions, fixed a few in passing). * docs: round 2 audit fixes + regenerate skill catalogs Follow-up to the previous commit on this branch: Round 2 manual fixes: - quickstart.md: KIMI_CODING_API_KEY mentioned alongside KIMI_API_KEY; voice-mode and ACP install commands rewritten — bare 'pip install ...' doesn't work for curl-installed setups (no pip on PATH, not in repo dir); replaced with 'cd ~/.hermes/hermes-agent && uv pip install -e ".[voice]"'. ACP already ships in [all] so the curl install includes it. - cli.md / configuration.md: 'auxiliary.compression.model' shown as 'google/gemini-3-flash-preview' (the doc's own claimed default); actual default is empty (= use main model). Reworded as 'leave empty (default) or pin a cheap model'. - built-in-plugins.md: added the bundled 'kanban/dashboard' plugin row that was missing from the table. Regenerated skill catalogs: - ran website/scripts/generate-skill-docs.py to refresh all 163 per-skill pages and both reference catalogs (skills-catalog.md, optional-skills-catalog.md). This adds the entries that were genuinely missing — productivity/teams-meeting-pipeline (bundled), optional/finance/* (entire category — 7 skills: 3-statement-model, comps-analysis, dcf-model, excel-author, lbo-model, merger-model, pptx-author), creative/hyperframes, creative/kanban-video-orchestrator, devops/watchers, productivity/shop-app, research/searxng-search, apple/macos-computer-use — and rewrites every other per-skill page from the current SKILL.md. Most diffs are tiny (one line of refreshed metadata). Validation: - 'npm run build' succeeded. - Broken-link count moved 146 -> 155 — the +9 are zh-Hans translation shells that lag every newly-added skill page (pre-existing pattern). No regressions on any en/ page.
168 lines
6.7 KiB
Markdown
168 lines
6.7 KiB
Markdown
---
|
|
title: "Ideation — Generate project ideas via creative constraints"
|
|
sidebar_label: "Ideation"
|
|
description: "Generate project ideas via creative constraints"
|
|
---
|
|
|
|
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
|
|
|
|
# Ideation
|
|
|
|
Generate project ideas via creative constraints.
|
|
|
|
## Skill metadata
|
|
|
|
| | |
|
|
|---|---|
|
|
| Source | Bundled (installed by default) |
|
|
| Path | `skills/creative/creative-ideation` |
|
|
| Version | `1.0.0` |
|
|
| Author | SHL0MS |
|
|
| License | MIT |
|
|
| Platforms | linux, macos, windows |
|
|
| Tags | `Creative`, `Ideation`, `Projects`, `Brainstorming`, `Inspiration` |
|
|
|
|
## Reference: full SKILL.md
|
|
|
|
:::info
|
|
The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
|
|
:::
|
|
|
|
# Creative Ideation
|
|
|
|
## When to use
|
|
|
|
Use when the user says 'I want to build something', 'give me a project idea', 'I'm bored', 'what should I make', 'inspire me', or any variant of 'I have tools but no direction'. Works for code, art, hardware, writing, tools, and anything that can be made.
|
|
|
|
Generate project ideas through creative constraints. Constraint + direction = creativity.
|
|
|
|
## How It Works
|
|
|
|
1. **Pick a constraint** from the library below — random, or matched to the user's domain/mood
|
|
2. **Interpret it broadly** — a coding prompt can become a hardware project, an art prompt can become a CLI tool
|
|
3. **Generate 3 concrete project ideas** that satisfy the constraint
|
|
4. **If they pick one, build it** — create the project, write the code, ship it
|
|
|
|
## The Rule
|
|
|
|
Every prompt is interpreted as broadly as possible. "Does this include X?" → Yes. The prompts provide direction and mild constraint. Without either, there is no creativity.
|
|
|
|
## Constraint Library
|
|
|
|
### For Developers
|
|
|
|
**Solve your own itch:**
|
|
Build the tool you wished existed this week. Under 50 lines. Ship it today.
|
|
|
|
**Automate the annoying thing:**
|
|
What's the most tedious part of your workflow? Script it away. Two hours to fix a problem that costs you five minutes a day.
|
|
|
|
**The CLI tool that should exist:**
|
|
Think of a command you've wished you could type. `git undo-that-thing-i-just-did`. `docker why-is-this-broken`. `npm explain-yourself`. Now build it.
|
|
|
|
**Nothing new except glue:**
|
|
Make something entirely from existing APIs, libraries, and datasets. The only original contribution is how you connect them.
|
|
|
|
**Frankenstein week:**
|
|
Take something that does X and make it do Y. A git repo that plays music. A Dockerfile that generates poetry. A cron job that sends compliments.
|
|
|
|
**Subtract:**
|
|
How much can you remove from a codebase before it breaks? Strip a tool to its minimum viable function. Delete until only the essence remains.
|
|
|
|
**High concept, low effort:**
|
|
A deep idea, lazily executed. The concept should be brilliant. The implementation should take an afternoon. If it takes longer, you're overthinking it.
|
|
|
|
### For Makers & Artists
|
|
|
|
**Blatantly copy something:**
|
|
Pick something you admire — a tool, an artwork, an interface. Recreate it from scratch. The learning is in the gap between your version and theirs.
|
|
|
|
**One million of something:**
|
|
One million is both a lot and not that much. One million pixels is a 1MB photo. One million API calls is a Tuesday. One million of anything becomes interesting at scale.
|
|
|
|
**Make something that dies:**
|
|
A website that loses a feature every day. A chatbot that forgets. A countdown to nothing. An exercise in rot, killing, or letting go.
|
|
|
|
**Do a lot of math:**
|
|
Generative geometry, shader golf, mathematical art, computational origami. Time to re-learn what an arcsin is.
|
|
|
|
### For Anyone
|
|
|
|
**Text is the universal interface:**
|
|
Build something where text is the only interface. No buttons, no graphics, just words in and words out. Text can go in and out of almost anything.
|
|
|
|
**Start at the punchline:**
|
|
Think of something that would be a funny sentence. Work backwards to make it real. "I taught my thermostat to gaslight me" → now build it.
|
|
|
|
**Hostile UI:**
|
|
Make something intentionally painful to use. A password field that requires 47 conditions. A form where every label lies. A CLI that judges your commands.
|
|
|
|
**Take two:**
|
|
Remember an old project. Do it again from scratch. No looking at the original. See what changed about how you think.
|
|
|
|
See `references/full-prompt-library.md` for 30+ additional constraints across communication, scale, philosophy, transformation, and more.
|
|
|
|
## Matching Constraints to Users
|
|
|
|
| User says | Pick from |
|
|
|-----------|-----------|
|
|
| "I want to build something" (no direction) | Random — any constraint |
|
|
| "I'm learning [language]" | Blatantly copy something, Automate the annoying thing |
|
|
| "I want something weird" | Hostile UI, Frankenstein week, Start at the punchline |
|
|
| "I want something useful" | Solve your own itch, The CLI that should exist, Automate the annoying thing |
|
|
| "I want something beautiful" | Do a lot of math, One million of something |
|
|
| "I'm burned out" | High concept low effort, Make something that dies |
|
|
| "Weekend project" | Nothing new except glue, Start at the punchline |
|
|
| "I want a challenge" | One million of something, Subtract, Take two |
|
|
|
|
## Output Format
|
|
|
|
```
|
|
## Constraint: [Name]
|
|
> [The constraint, one sentence]
|
|
|
|
### Ideas
|
|
|
|
1. **[One-line pitch]**
|
|
[2-3 sentences: what you'd build and why it's interesting]
|
|
⏱ [weekend / week / month] • 🔧 [stack]
|
|
|
|
2. **[One-line pitch]**
|
|
[2-3 sentences]
|
|
⏱ ... • 🔧 ...
|
|
|
|
3. **[One-line pitch]**
|
|
[2-3 sentences]
|
|
⏱ ... • 🔧 ...
|
|
```
|
|
|
|
## Example
|
|
|
|
```
|
|
## Constraint: The CLI tool that should exist
|
|
> Think of a command you've wished you could type. Now build it.
|
|
|
|
### Ideas
|
|
|
|
1. **`git whatsup` — show what happened while you were away**
|
|
Compares your last active commit to HEAD and summarizes what changed,
|
|
who committed, and what PRs merged. Like a morning standup from your repo.
|
|
⏱ weekend • 🔧 Python, GitPython, click
|
|
|
|
2. **`explain 503` — HTTP status codes for humans**
|
|
Pipe any status code or error message and get a plain-English explanation
|
|
with common causes and fixes. Pulls from a curated database, not an LLM.
|
|
⏱ weekend • 🔧 Rust or Go, static dataset
|
|
|
|
3. **`deps why <package>` — why is this in my dependency tree**
|
|
Traces a transitive dependency back to the direct dependency that pulled
|
|
it in. Answers "why do I have 47 copies of lodash" in one command.
|
|
⏱ weekend • 🔧 Node.js, npm/yarn lockfile parsing
|
|
```
|
|
|
|
After the user picks one, start building — create the project, write the code, iterate.
|
|
|
|
## Attribution
|
|
|
|
Constraint approach inspired by [wttdotm.com/prompts.html](https://wttdotm.com/prompts.html). Adapted and expanded for software development and general-purpose ideation.
|