Skill Prompt Evolution

Unified task-observer skill for OpenCode — continuous skill discovery and improvement with Spanish-first pattern detection, session database mining, and auto-install.

Features

• 8-phase workflow: DB Mining, Post-Session Report, Skill Audit, Skill Personalization, Weekly Review, Change Consistency Check, Prompt Review, Observation Mode
• Spanish-first patterns: 14 intent categories with 200+ Spanish phrases as primary detection, English as secondary
• QWERTY typo correction: Built-in keyboard adjacency normalization for Spanish QWERTY keyboards
• Session database mining: Automatic detection of workflow candidates from OpenCode session history
• Auto-install: Node.js installer patches existing config files with only what's needed
• Self-contained: All scripts, rubrics, and references bundled — no external dependencies

Known Limitations

• Plan mode auto-load: In OpenCode's GLM-5.2 model, the system-reminder blocks skill() tool calls in Plan mode. The skill loads correctly in Build mode. This is a known OpenCode runtime limitation, not a skill bug.
• Only tested with OpenCode: Compatibility with other coding agents (Cursor, Windsurf, Aider, etc.) is unknown and should be explored in future work.
• Pattern detection: Spanish patterns are comprehensive but may need expansion for regional variations.

Installation

From GitHub

git clone https://github.com/tmogeid/skill-prompt-evolution.git
cd skill-prompt-evolution
node install.js

From npm

npx skill-prompt-evolution

Uninstall

node uninstall.js
# or
npx skill-prompt-evolution-uninstall

Options

--config-dir <path>   OpenCode config directory (default: ~/.config/opencode)
--dry-run             Preview changes without writing

What the Installer Does

1. Copies skill files to ~/.config/opencode/skills/task-observer/
2. Patches AGENTS.md — adds auto-load instruction for session start
3. Patches prompts — adds PRE-FLIGHT CHECK to plan.txt, build.txt, boss.txt
4. Patches opencode.json — adds skill permission for Plan agent

All patches are idempotent — running install again won't duplicate content.

Project Structure

skill-prompt-evolution/
├── skill/
│   ├── SKILL.md              # Main skill file (1195 lines)
│   └── USER-GUIDE.md         # User guide from upstream
├── patches/
│   ├── agents.md.patch       # Addition to AGENTS.md
│   ├── plan.txt.patch        # PRE-FLIGHT CHECK for plan.txt
│   ├── build.txt.patch       # PRE-FLIGHT CHECK for build.txt
│   └── boss.txt.patch        # PRE-FLIGHT CHECK for boss.txt
├── config/
│   └── opencode.json.patch   # Plan agent permission config
├── references/
│   ├── audit-rubric.md       # 9-dimension skill audit framework
│   ├── personalization-rubric.md  # 5-step personalization guide
│   ├── discovery-rubric.md   # Evidence sources for DB mining
│   ├── scoring-rubric.md     # 5-dimension candidate scoring
│   ├── patterns.json         # Workflow patterns (complementary)
│   ├── environments.md       # Activation setup and config
│   ├── skill-authoring.md    # Taxonomy, licensing, editing rules
│   └── weekly-review.md      # Comprehensive review procedure
├── scripts/
│   ├── scan_sessions.py      # DB mining with Spanish-first patterns
│   └── export_opencode.py    # OpenCode SQLite → JSONL export
├── install.js                # Node.js installer
├── uninstall.js              # Node.js uninstaller
├── package.json              # npm package config
├── LICENSE.txt               # PolyForm Noncommercial 1.0.0
├── .gitignore
└── README.md                 # This file

Pattern Detection

Spanish-first INTENT_PATTERNS (in scan_sessions.py)

| Category | Spanish Phrases | English Equivalents | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | | review | revisa, revisar, revisión, code review, chequear, auditar, inspeccionar, echar un vistazo, leer el código, leer el diff | check, inspect, audit, examine, peer review, scrutinize | | debug | depurar, depura, depuración, arreglar, falla, falló, fallando, bug, solucionar bug, investigar error, causa raíz, no funciona, se rompió, está roto, crash, crashea, excepción | fix, fixing, fails, failing, error, broken, crashes, exception, root cause, not working | | publish | commit, commitear, hacer commit, push, subir commits, publicar, lanzar release, versión nueva, tag, git push, pull request, abrir PR | commits, committing, pushing, publishing, releasing, new version, open PR | | deploy_remote | desplegar, despliegue, despliegue remoto, ssh, túnel, port forwarding, exponer puerto, servidor remoto, docker-compose, orquestar contenedores, kubernetes, terraform | deployment, deploying, ship, ssh connection, tunneling, docker, container, helm chart | | research | investigar, investigación exhaustiva, investigación profunda, analizar, analizar profundamente, profundizar, buscar información, recopilar datos, comparar opciones, benchmark | research, investigating, deep research, analyze, analyze in depth, gather information | | install_setup | instalar, instalación, configurar, configurar entorno, inicializar proyecto, npm install, pip install, dependencias faltantes, configurar credenciales, autenticar, token de api, variables de entorno, secretos | install, installation, configure, configure environment, install packages | | docs_write | documentación, documentar, escribir docs, actualizar docs, readme, changelog, escribir guía, tutorial, comentarios de código, docstring, manual de usuario | documentation, docs, write docs, update docs, guide, write tutorial | | skill_work | crear skill, nuevas skills, instalar skill, plugin, sistema de plugins, auditar skills, skill evolution, ciclo de vida skill, gestionar skills | create skill, new skill, configure skill, plugin system | | frontend | interfaz de usuario, diseño de ui, maquetación, componentes, renderizar, diseño responsive, mobile-first, dark mode, experiencia de usuario | user interface, interface design, component, rendering, responsive design | | data_doc | hoja de cálculo, archivo csv, exportar datos, base de datos, consulta sql, análisis de datos, parsear csv, visualización de datos, graficar, reporte, dashboard | spreadsheet, data file, export data, relational database, data analysis | | code_impl | implementar, crear función, crear clase, agregar feature, modificar código, construir, desarrollar, escribir código, endpoint, nueva api, scaffold | implement, create function, create class, add feature, build feature | | testing | pruebas unitarias, probar código, prueba de integración, pruebas e2e, cobertura, mock, test suite, ejecutar tests, test fallido, regresión | unit testing, integration testing, e2e testing, test coverage, run tests | | refactor | refactorizar, limpiar código, optimizar código, simplificar código, reducir complejidad, eliminar duplicados, extraer función, renombrar variable, deuda técnica | refactoring, clean up code, optimize code, reduce complexity, remove duplication | | correction_frustration | no me entendiste, te equivocaste, está mal, no es lo que pedí, otra vez no, siempre igual, estoy cansado, no funciona nada, ¿estás seguro? | you're wrong, that's wrong, not again, i'm tired, doesn't work, are you sure |

Complementary patterns.json (from skill-optimizer)

Workflow-specific patterns for cross-project detection: Codex/Coproxy recovery, paper reading, project promotion, CI/release, remote service, WeChat, frontend regression, skill lifecycle, multi-agent orchestration, OpenCode config, MemPalace memory, security scanning, deployment automation.

Authors

Original Works

| Author | Contribution | License | | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | Eoghan Henn / rebelytics.com | task-observer base (SKILL.md, USER-GUIDE.md, references/environments.md, references/skill-authoring.md, references/weekly-review.md) | CC BY 4.0 | | Haoqing Wang / hqhq1025 | skill-miner + skill-personalizer (scripts/scan_sessions.py, references/audit-rubric.md, references/personalization-rubric.md, references/discovery-rubric.md, references/scoring-rubric.md, references/patterns.json) | MIT |

This Fork

| Author | Contribution | | ----------- | ----------------------------------------------------------------------------------------------------------- | | tmogeid | Unified skill integration, Spanish-first patterns, QWERTY normalization, install.js, patches, modifications |

License

This project is licensed under the PolyForm Noncommercial License 1.0.0.

• Free for personal, educational, and research use
• Commercial use requires separate written permission
• See LICENSE.txt for full terms

Attribution Requirements

Any use, modification, or distribution must include:

1. Copyright notice: "Copyright (c) 2026 tmogeid"
2. References to original works and their licenses
3. A copy of the PolyForm Noncommercial License

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

For commercial contributions or licensing questions, contact tmogeid.

Compatibility

• OpenCode: Tested with GLM-5.2 model
• Other agents: Unknown — contributions welcome for testing with Cursor, Windsurf, Aider, etc.
• Python: 3.10+ required for scripts
• Node.js: 16.0+ required for installer

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Built with care by tmogeid. Based on the work of Eoghan Henn and Haoqing Wang.