{ "version": 1, "generatedAt": "2026-05-15T13:35:20.636Z", "skillCount": 14, "skills": [ { "id": "ai-documents-validation-document-type", "name": "AI Documents Validation Document Type", "description": "Develop, extend, plan, review, or integrate supported document types in the ai-documents-validation/docvalidator repository. Use when Codex must add a new document type, modify field extraction parsers, align classification REFERENCE_TEXTS, field diagnostics, business rules, reliability, API catalog, CLI, tests, public documentation, or integrate the FastAPI validation API into another application for E:\\ai-documents-validation or the canonical ai_documents_validation project.", "category": "validation", "triggers": { "keywords": [ "extend", "plan", "integrate", "supported", "types", "ai-documents-validation", "docvalidator", "repository", "codex", "add", "new", "type", "modify", "field", "extraction", "parsers", "align", "classification", "reference_texts", "diagnostics", "business", "reliability", "api", "catalog", "cli", "tests", "public", "documentation", "fastapi", "validation", "application", "canonical", "ai_documents_validation" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-technical-analyst", "mcp-master-orchestrator", "mcp-code-reviewer", "mcp-docs-navigator", "mcp-office-expert" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-browser-automation", "name": "MCP Browser Automation", "description": "Navigate, inspect, and validate web interfaces with Playwright MCP, including iframe-heavy pages, downloads, and session reuse. Use when the agent must reproduce UI flows, verify post-fix behavior, or inspect browser-side failures.", "category": "testing", "triggers": { "keywords": [ "navigate", "web", "interfaces", "playwright", "mcp", "iframe-heavy", "pages", "downloads", "session", "reuse", "reproduce", "flows", "post-fix", "behavior", "browser-side", "failures" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-database-expert", "mcp-coldfusion-developer" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-code-reviewer", "name": "MCP Code Reviewer", "description": "Review code snippets, files, commits, diffs, branches, or pull requests with priority on local project rules, readability, maintainability, correctness, robustness, performance, test coverage, and available functional context. Use when the user asks for code review, quality assessment, consistency against project conventions, risk/regression analysis, or actionable findings with fix guidance for an agent.", "category": "review", "triggers": { "keywords": [ "snippets", "commits", "diffs", "branches", "pull", "requests", "priority", "readability", "maintainability", "correctness", "robustness", "performance", "coverage", "functional", "quality", "assessment", "consistency", "conventions", "risk", "regression", "analysis", "actionable", "findings", "fix", "guidance" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-technical-analyst", "mcp-master-orchestrator" ], "antiPatterns": [ "primario se serve ricostruzione ampia ticket + docs + allegati + commit distribuiti: passa a `mcp-technical-analyst`. us" ], "gates": [] }, { "id": "mcp-coldfusion-developer", "name": "MCP ColdFusion Developer", "description": "Develop and debug CFML safely with linting, bridge inspection, log analysis, and post-fix validation handoffs. Use when the agent must inspect ColdFusion code, trace runtime errors, or validate a CFML change through docs, logs, and UI checks.", "category": "development", "triggers": { "keywords": [ "cfml", "linting", "bridge", "inspection", "analysis", "post-fix", "validation", "handoffs", "coldfusion", "runtime", "errors", "checks" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-technical-analyst", "mcp-master-orchestrator", "mcp-browser-automation", "mcp-docs-navigator", "mcp-git-mantis-workflow", "mcp-database-expert", "mcp-office-expert" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-database-expert", "name": "MCP Database Expert", "description": "Query, lint, inspect schema, analyze plans, and hand off SQL results to docs, office, and ticket workflows. Use when the agent must interrogate a database via MCP, validate SQL, export results, or trace executed queries back to project context.", "category": "data", "triggers": { "keywords": [ "query", "lint", "schema", "analyze", "plans", "hand", "off", "sql", "results", "office", "ticket", "workflows", "interrogate", "database", "mcp", "executed", "queries" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-docs-navigator", "mcp-office-expert", "mcp-git-mantis-workflow" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-docs-navigator", "name": "MCP Docs Navigator", "description": "Search, tag, scan, and maintain project documentation through docs-node. Use when the agent must retrieve procedures, organize Markdown corpora, ingest exported office documents, or classify knowledge for other MCP workflows.", "category": "docs", "triggers": { "keywords": [ "search", "tag", "scan", "maintain", "documentation", "docs-node", "retrieve", "procedures", "organize", "markdown", "corpora", "ingest", "exported", "office", "classify", "knowledge", "other", "mcp", "workflows" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-office-expert", "mcp-technical-analyst" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-git-mantis-workflow", "name": "MCP Git & Mantis Workflow", "description": "Correlate tickets, commits, attachments, rebases, and merge/rebase conflicts across git-node and mantis-node. Use when the agent must investigate issue history, connect code changes to Mantis, plan or validate a rebase, resolve Git conflicts, compare original vs rebased commit series with range-diff, download artifacts, or coordinate technical handoffs without losing traceability.", "category": "traceability", "triggers": { "keywords": [ "tickets", "commits", "attachments", "rebases", "merge", "rebase", "conflicts", "across", "git-node", "mantis-node", "investigate", "issue", "history", "changes", "mantis", "plan", "git", "compare", "original", "rebased", "commit", "series", "range-diff", "download", "artifacts", "technical", "handoffs", "traceability" ], "promptPatterns": [ "parti dal ticket", "collega commit", "scarica allegato", "ricostruisci storia" ], "escalationPhrases": [] }, "sidecar": [ "mcp-docs-navigator", "mcp-database-expert", "mcp-coldfusion-developer", "mcp-browser-automation", "mcp-technical-analyst" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-mantis-ticket-writer", "name": "MCP Mantis Ticket Writer", "description": "Draft or refine MantisBT ticket text using the corporate default template and produce complete copy-paste sections (Riassunto, Description, Steps To Reproduce, Additional Information when applicable). Use when the main goal is disciplined ticket writing, not full multi-source technical intake.", "category": "ticketing", "triggers": { "keywords": [ "mantisbt", "ticket", "text", "corporate", "default", "template", "copy-paste", "riassunto", "description", "steps", "reproduce", "additional", "information", "disciplined", "writing", "multi-source", "technical", "intake" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-technical-analyst", "mcp-master-orchestrator" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-master-orchestrator", "name": "MCP Master Orchestrator", "description": "Coordinate multi-step MCP work across docs, git, mantis, database, ColdFusion, browser, office, SVG/visual-asset, and technical-analysis flows. Use when the goal spans multiple phases such as bug triage, rebase/conflict-resolution coordination, reporting, onboarding, data migration, visual deliverables, post-fix validation, or a technical analysis that starts from tickets, documents, attachments, commits, or mixed evidence.", "category": "orchestration", "triggers": { "keywords": [ "multi-step", "mcp", "work", "across", "git", "mantis", "database", "coldfusion", "browser", "office", "svg", "visual-asset", "technical-analysis", "flows", "phases", "bug", "triage", "rebase", "conflict-resolution", "coordination", "reporting", "onboarding", "data", "migration", "visual", "deliverables", "post-fix", "validation", "technical", "analysis", "tickets", "attachments", "commits", "mixed", "evidence", "prompt", "chiede", "analisi", "ticket", "documenti", "allegati", "commit", "escalare", "mcp-technical-analyst" ], "promptPatterns": [], "escalationPhrases": [ "se il prompt chiede analisi da ticket/documenti/allegati/commit, escalare a `mcp-technical-analyst`", "se il prompt chiede un'a" ] }, "sidecar": [ "mcp-git-mantis-workflow", "mcp-docs-navigator", "mcp-coldfusion-developer", "mcp-browser-automation", "mcp-technical-analyst", "mcp-database-expert", "mcp-office-expert", "mcp-sophia-yii-developer", "mcp-memory-operator" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-memory-operator", "name": "MCP Memory Operator", "description": "Save, retrieve, and curate operational memory in memory-node with safe hygiene rules (no secrets, no noise, project-scoped context) and concise handoff notes. Use when the task needs reusable decisions, validated workarounds, or cross-session continuity.", "category": "memory", "triggers": { "keywords": [ "save", "retrieve", "curate", "operational", "memory", "memory-node", "hygiene", "secrets", "noise", "project-scoped", "concise", "handoff", "notes", "reusable", "decisions", "validated", "workarounds", "cross-session", "continuity" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-technical-analyst", "mcp-master-orchestrator", "mcp-docs-navigator" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-office-expert", "name": "MCP Office Expert", "description": "Read, create, and edit Word, Excel, and PDF files through MCP, including report generation and document export for docs indexing. Use when the task involves local documents, spreadsheet outputs, PDF extraction, or shared deliverables.", "category": "office", "triggers": { "keywords": [ "word", "excel", "pdf", "mcp", "report", "generation", "indexing", "spreadsheet", "extraction", "deliverables" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-docs-navigator", "mcp-database-expert", "mcp-technical-analyst" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-sophia-yii-developer", "name": "MCP Sophia Yii Developer", "description": "Develop and debug Sophia Framework 2 applications based on Yii 1.1, including FRM/APP/CLI-client layering, controllerMap overrides, RenderSettings forms and grids, Gii custom scaffolding, Cruge/RBAC permissions, exports, DB scripts, PHP syntax linting, and post-fix validation. Use this whenever the user asks to inspect, modify, generate, debug, review, or validate PHP/Yii code in a Sophia application, even if they only mention Yii, Sophia, Musa, controllerMap, RenderSettings, FrmGridView, Cruge, Gii, export, or script DB.", "category": "development", "triggers": { "keywords": [ "sophia", "framework", "applications", "yii", "frm", "app", "cli-client", "layering", "controllermap", "overrides", "rendersettings", "forms", "grids", "gii", "custom", "scaffolding", "cruge", "rbac", "permissions", "exports", "scripts", "php", "syntax", "linting", "post-fix", "validation", "modify", "application", "musa", "frmgridview", "script" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-technical-analyst", "mcp-master-orchestrator", "mcp-docs-navigator", "mcp-database-expert", "mcp-browser-automation", "mcp-git-mantis-workflow", "mcp-code-reviewer", "mcp-office-expert" ], "antiPatterns": [], "gates": [] }, { "id": "mcp-technical-analyst", "name": "MCP Technical Analyst", "description": "Technical analysis skill for multi-source investigations across tickets, docs, commits, repos, DBs, attachments, and environments. Use for gap analysis, stato dell'arte, dossiers, requirement reconstruction, or evidence-based Markdown deliverables. Do not use for single-domain tasks better handled by specialist skills.", "category": "analysis", "triggers": { "keywords": [ "technical", "analysis", "skill", "multi-source", "investigations", "across", "tickets", "commits", "repos", "dbs", "attachments", "environments", "gap", "stato", "dell", "arte", "dossiers", "requirement", "reconstruction", "evidence-based", "markdown", "deliverables", "single-domain", "tasks", "better", "handled", "specialist", "skills" ], "promptPatterns": [ "Parti dal ticket {ticket_id} in modalita ticket-first-light. Fornisci contesto, evidenze osservate, inferenze iniziali e punti aperti prioritari. Se rilevi complessita multi-sorgente, indica l'escalation al ticket-first completo." ], "escalationPhrases": [] }, "sidecar": [ "mcp-git-mantis-workflow", "mcp-docs-navigator", "mcp-database-expert", "mcp-office-expert", "mcp-coldfusion-developer", "mcp-sophia-yii-developer", "mcp-browser-automation", "mcp-memory-operator" ], "antiPatterns": [ "il task e mono-dominio: solo sql, solo docs, solo cfml, solo sophia/yii, solo browser o solo office" ], "gates": [ { "condition": "Multi-source", "description": "Correlare almeno 2 fonti tra ticket, docs, commit, DB, allegati o ambienti" }, { "condition": "Deliverable analitico", "description": "Stato dell'arte, gap analysis, dossier, requisiti o confronto ambienti" }, { "condition": "Conflitto prove", "description": "Ticket, codice, docs o DB dicono cose diverse" }, { "condition": "Avvio rapido", "description": "Ticket breve/ambiguo e serve prima fotografia tecnica" } ] }, { "id": "svg", "name": "SVG Skill", "description": "Usa questa skill per lavorare su SVG esistenti o crearne di semplici quando servono passaggi tecnici verificabili: optimize, validate, palette/brand-kit, conversione componente, from-raster, export PNG/PDF, helper geometrici, QA visiva o riuso di asset SVG locali indicizzati. Non usarla come skill di generazione illustrativa creativa pura; usala invece per trasformazioni, validazioni, asset discovery locale e fallback espliciti.", "category": "visual", "triggers": { "keywords": [ "usa", "questa", "skill", "lavorare", "svg", "esistenti", "crearne", "semplici", "quando", "servono", "passaggi", "tecnici", "verificabili", "optimize", "palette", "brand-kit", "conversione", "componente", "from-raster", "png", "pdf", "helper", "geometrici", "visiva", "riuso", "asset", "locali", "indicizzati", "usarla", "come", "generazione", "illustrativa", "creativa", "pura", "usala", "invece", "trasformazioni", "validazioni", "discovery", "locale", "fallback", "espliciti" ], "promptPatterns": [], "escalationPhrases": [] }, "sidecar": [ "mcp-master-orchestrator" ], "antiPatterns": [], "gates": [] } ], "composites": [ { "id": "bug-triage", "signals": [ "ticket", "bug", "regressione", "regression", "fix", "errore", "error" ], "workflow": [ "mcp-technical-analyst", "mcp-coldfusion-developer|mcp-sophia-yii-developer", "mcp-code-reviewer" ], "hint": "Sophia routing: bug triage workflow detected. Consider: 1) mcp-technical-analyst for intake, 2) domain skill for fix, 3) mcp-code-reviewer for validation." }, { "id": "report-generation", "signals": [ "report", "esporta", "export", "allega", "attach", "consegnabile", "deliverable" ], "workflow": [ "mcp-database-expert|mcp-technical-analyst", "mcp-office-expert", "mcp-docs-navigator" ], "hint": "Sophia routing: report/deliverable workflow detected. Consider: 1) data source skill, 2) mcp-office-expert for formatting, 3) mcp-docs-navigator for indexing." }, { "id": "ticket-writing", "signals": [ "scrivi ticket", "nuovo ticket", "crea ticket", "redigi ticket", "drafta ticket" ], "workflow": [ "mcp-mantis-ticket-writer" ], "hint": "Sophia routing: ticket drafting detected. Use mcp-mantis-ticket-writer for structured output with template." }, { "id": "rebase-workflow", "signals": [ "rebase", "range-diff", "range_diff", "conflitti merge", "merge conflict" ], "workflow": [ "mcp-git-mantis-workflow" ], "hint": "Sophia routing: rebase/conflict workflow detected. Use mcp-git-mantis-workflow with rebase-playbook reference." }, { "id": "doc-ingest", "signals": [ "indicizza", "index", "ingest", "importa documento", "scan_folder", "corpus" ], "workflow": [ "mcp-office-expert", "mcp-docs-navigator" ], "hint": "Sophia routing: document ingestion detected. Use mcp-office-expert for conversion, then mcp-docs-navigator for indexing and tagging." } ], "intents": [ { "id": "multi-source-analysis", "description": "Cross-correlating 2+ source types", "signals": [ { "any": [ "ticket", "mantis", "issue", "bug", "segnalazione" ], "label": "ticket" }, { "any": [ "docs", "documentazione", "documenti", "documento", "procedura", "manuale", "wiki" ], "label": "docs" }, { "any": [ "commit", "branch", "diff", "blame", "git", "history" ], "label": "git" }, { "any": [ "database", "schema", "query", "sql", "tabella", "tabelle", "dati" ], "label": "db" }, { "any": [ "allegato", "allegati", "attachment", "pdf", "excel", "docx" ], "label": "attachment" } ], "minDistinctGroups": 2, "boost": { "skillId": "mcp-technical-analyst", "score": 5 } }, { "id": "ticket-driven", "description": "Explicit ticket reference", "signals": [ { "pattern": "#\\d{3,}" }, { "pattern": "ticket\\s+\\d+" }, { "pattern": "mantis\\s+\\d+" }, { "pattern": "issue\\s+\\d+" } ], "boost": { "skillId": "mcp-technical-analyst", "score": 3 } }, { "id": "write-then-validate", "description": "Modify code then validate", "signals": [ { "any": [ "modifica", "fix", "aggiungi", "rimuovi", "cambia", "implementa", "edit", "add", "remove" ], "label": "write" }, { "any": [ "verifica", "test", "lint", "review", "controlla", "validate", "check", "valuta" ], "label": "validate" } ], "minDistinctGroups": 2, "boost": { "skillId": "mcp-code-reviewer", "score": 2 } } ] }