Unified task-observer skill for OpenCode — continuous skill discovery and improvement with Spanish-first pattern detection, session database mining, and auto-install.
- 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
- 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.
git clone https://github.com/tmogeid/skill-prompt-evolution.git
cd skill-prompt-evolution
node install.jsnpx skill-prompt-evolutionnode uninstall.js
# or
npx skill-prompt-evolution-uninstall--config-dir <path> OpenCode config directory (default: ~/.config/opencode)
--dry-run Preview changes without writing
- Copies skill files to
~/.config/opencode/skills/task-observer/ - Patches AGENTS.md — adds auto-load instruction for session start
- Patches prompts — adds PRE-FLIGHT CHECK to
plan.txt,build.txt,boss.txt - Patches opencode.json — adds skill permission for Plan agent
All patches are idempotent — running install again won't duplicate content.
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
| 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 |
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.
| 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 |
| Author | Contribution |
|---|---|
| tmogeid | Unified skill integration, Spanish-first patterns, QWERTY normalization, install.js, patches, modifications |
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
Any use, modification, or distribution must include:
- Copyright notice: "Copyright (c) 2026 tmogeid"
- References to original works and their licenses
- A copy of the PolyForm Noncommercial License
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Submit a pull request
For commercial contributions or licensing questions, contact tmogeid.
- 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
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Built with care by tmogeid. Based on the work of Eoghan Henn and Haoqing Wang.