Skip to content
Uvilo OS
approved Visibility internal Owner erik@uvilo.com Approver _ Created _ Updated _

Knowledge Consistency Plan 2

Plan 2 — Skill File Content Corrections

Scope: Correct skill file content across Forge skills: rename Orchestration to Agentic_Prompts, update Update_Infrastructure, remove Forge_Chat_Prompt.md references, eliminate LibreChat references, fix filesystem paths, remove MongoDB references, replace hardcoded model names with use-case names, and remove inline model quirks (moving them to Choose_AI_Model reference files created in Plan 1).

Spec sections covered: S1.1, S1.2, S1.3 (skills only), S1.4, S1.5 (skills only), S1.8, S7.2 (skills only), S7.3 (skill quirk removal only).

Prerequisite: Plan 1 (model reference files must exist before removing inline quirks from skills in Task 8).

Task 1 — Rename Orchestration Skill to Agentic_Prompts

Spec S1.1: “The Orchestration skill is renamed to Agentic_Prompts. The deprecation notice is removed. The skill’s description explains that its /references directory contains system prompts for OpenClaw and Clause Code that can be used as inspiration and information when building skills. The skill remains in the Available Skills list under its new name.”

Steps

  1. Rename the skill folder Forge/Skills/Orchestration/ to Forge/Skills/Agentic_Prompts/. This moves SKILL.md and the references/ subfolder together.
  2. In Forge/Skills/Agentic_Prompts/SKILL.md, update the frontmatter name field from Orchestration to Agentic_Prompts.
  3. Remove any deprecation notice from the SKILL.md body.
  4. Update the skill description to explain that its /references directory contains system prompts for OpenClaw and Clause Code that can be used as inspiration and information when building skills.
  5. Spawn the Page Manager bot via spawnAgent with { botGroup: "forge", botHandle: "page-manager" } to update the sidebar entry from Orchestration to Agentic_Prompts, pointing to Forge/Skills/Agentic_Prompts/SKILL.md.

Verify

  • Forge/Skills/Agentic_Prompts/SKILL.md exists with name: Agentic_Prompts in frontmatter
  • Forge/Skills/Agentic_Prompts/references/ subfolder exists and is populated
  • No deprecation notice remains in the SKILL.md
  • The description mentions the /references directory and its contents
  • Forge/Skills/Orchestration/ no longer exists
  • Sidebar entry updated to Agentic_Prompts

Task 2 — Update Update_Infrastructure Skill

Spec S1.2: “The Update_Infrastructure skill is updated to reflect current infrastructure practices. The ‘outdated’ warning is removed. The skill references docs/deployment.md in the uvilo-mono repository (prodRepoRoot) and the uvilo-mono repo structure for current deployment, database branching, migration, and environment configuration procedures.”

Steps

  1. Edit Forge/Skills/Update_Infrastructure/SKILL.md.
  2. Remove the “outdated” warning if present.
  3. Update references to point to docs/deployment.md in the uvilo-mono repository (prodRepoRoot — /workspace/erik@uvilo.com/uvilo-mono) for current deployment procedures.
  4. Update references to the uvilo-mono repo structure for database branching, migration, and environment configuration procedures.

Verify

  • Forge/Skills/Update_Infrastructure/SKILL.md contains no “outdated” warning
  • The SKILL.md references docs/deployment.md in uvilo-mono (prodRepoRoot)
  • The SKILL.md references uvilo-mono repo structure for deployment, database branching, migration, and environment configuration

Task 3 — Remove Forge_Chat_Prompt.md References from Skills

Spec S1.3: “No skill or knowledge file references Forge/Configs/Agents/Forge_Chat_Prompt.md. The file does not exist — the Forge Chat prompt lives in the Bot database. Specifically: Forge_Optimizer skill: The prerequisite checking for Forge_Chat_Prompt.md is removed. Create_Skill skill: Step 5 is updated to reference the Persistent Knowledge database prompt (where the Available Skills list resides) instead of the file path.”

Steps

  1. Edit Forge/Skills/Forge_Optimizer/SKILL.md: remove any prerequisite checking that references Forge/Configs/Agents/Forge_Chat_Prompt.md.
  2. Edit Forge/Skills/Create_Skill/SKILL.md: in Step 5, replace references to Forge_Chat_Prompt.md file path with a reference to the Persistent Knowledge database prompt (where the Available Skills list resides).

Verify

  • grep -r 'Forge_Chat_Prompt' Forge/Skills/Forge_Optimizer/SKILL.md Forge/Skills/Create_Skill/SKILL.md returns no matches
  • The Create_Skill SKILL.md Step 5 references the Persistent Knowledge database prompt, not a file path

Task 4 — Eliminate LibreChat References from MCP Skills

Spec S1.4: “No skill references librechat.yaml or LibreChat-era configuration. Specifically: Linear_MCP and Suprsend_MCP skills: References to librechat.yaml are replaced with ‘Bot/MCP configuration’ or ‘uvilo-mono Bot system.’ Vercel_MCP skill: The bypass secret is read from the VERCEL_PROTECTION_BYPASS environment variable via /proc/1/environ, consistent with Forge_Infrastructure.md and the Playwright_MCP skill. The old method of reading from /workspace/librechat/.secrets is removed. MCP_Development skill: ‘LibreChat’s MCP client’ is replaced with ‘uvilo-mono’s MCP client.’”

Steps

  1. Edit Forge/Skills/Linear_MCP/SKILL.md: replace references to librechat.yaml with “Bot/MCP configuration” or “uvilo-mono Bot system.”
  2. Edit Forge/Skills/Suprsend_MCP/SKILL.md: replace references to librechat.yaml with “Bot/MCP configuration” or “uvilo-mono Bot system.”
  3. Edit Forge/Skills/Vercel_MCP/SKILL.md: update the bypass secret reading method to use the VERCEL_PROTECTION_BYPASS environment variable via /proc/1/environ, consistent with Forge_Infrastructure.md and the Playwright_MCP skill. Remove the old method of reading from /workspace/librechat/.secrets.
  4. Edit Forge/Skills/MCP_Development/SKILL.md: replace “LibreChat’s MCP client” with “uvilo-mono’s MCP client.”

Verify

  • grep -ri 'librechat' Forge/Skills/Linear_MCP/SKILL.md Forge/Skills/Suprsend_MCP/SKILL.md Forge/Skills/Vercel_MCP/SKILL.md Forge/Skills/MCP_Development/SKILL.md returns no matches
  • Vercel_MCP SKILL.md references VERCEL_PROTECTION_BYPASS via /proc/1/environ
  • MCP_Development SKILL.md references “uvilo-mono’s MCP client”

Task 5 — Fix Filesystem Paths in Skills

Spec S1.5: “No file references the incorrect path /workspace/erik/uvilo-os/. All hardcoded paths are replaced with either the correct /workspace/erik@uvilo.com/uvilo-os/ or the [[orgRepoRoot]] template variable where appropriate. Affected files: Forge/Skills/Git_Dashboard/SKILL.md, Forge/Skills/Home_Page/SKILL.md, Forge/Skills/Markdown_To_PDF/SKILL.md, Forge/Skills/Reindex_Typesense/SKILL.md.”

Steps

  1. Edit Forge/Skills/Git_Dashboard/SKILL.md: replace /workspace/erik/uvilo-os/ with /workspace/erik@uvilo.com/uvilo-os/ or [[orgRepoRoot]] as appropriate.
  2. Edit Forge/Skills/Home_Page/SKILL.md: same replacement.
  3. Edit Forge/Skills/Markdown_To_PDF/SKILL.md: same replacement.
  4. Edit Forge/Skills/Reindex_Typesense/SKILL.md: same replacement.

Verify

  • grep -r '/workspace/erik/uvilo-os/' Forge/Skills/Git_Dashboard/SKILL.md Forge/Skills/Home_Page/SKILL.md Forge/Skills/Markdown_To_PDF/SKILL.md Forge/Skills/Reindex_Typesense/SKILL.md returns no matches

Task 6 — Remove MongoDB References from Forge_Optimizer Skill

Spec S1.8: “No skill or knowledge file references MongoDB or the mongodb skill. MongoDB has been completely removed from the system. The Forge_Optimizer skill’s reference to Forge/Skills/MongoDB/SKILL.md for connection details is removed.”

Steps

  1. Edit Forge/Skills/Forge_Optimizer/SKILL.md: remove the reference to Forge/Skills/MongoDB/SKILL.md for connection details.
  2. Remove any other MongoDB references in this file.

Verify

  • grep -ri 'mongodb' Forge/Skills/Forge_Optimizer/SKILL.md returns no matches
  • grep -r 'MongoDB/SKILL' Forge/Skills/Forge_Optimizer/SKILL.md returns no matches

Task 7 — Replace Hardcoded Model Names with Use-Case Names in Skills

Spec S7.2: “Knowledge files and skills refer to use-case names (e.g., ‘the indexing use case’), not specific model names (e.g., ‘gpt-5.4-nano’). When a model is swapped, only the Choose_AI_Model skill’s table needs updating.”

Steps

  1. Search all skill files under Forge/Skills/ for hardcoded model names (e.g., gpt-5.4-nano, gpt-4o-mini, gpt-5.4, gpt-5.5, glm-5.2) outside of the Choose_AI_Model skill itself.
  2. For each occurrence, replace the hardcoded model name with the corresponding use-case name from the Choose_AI_Model skill’s Use Case Table (created in Plan 1 Task 1). For example, replace gpt-5.4-nano with “the indexing use case” where the context is about indexing/embedding generation.
  3. Do NOT modify the Choose_AI_Model skill itself — it is the source of truth for model names.
  4. Do NOT remove model quirk documentation in this task — that is handled in Task 8.

Verify

  • grep -r 'gpt-5\.4-nano\|gpt-4o-mini\|gpt-5\.4\|gpt-5\.5\|glm-5\.2' Forge/Skills/ --include='SKILL.md' | grep -v Choose_AI_Model returns no matches (outside the Choose_AI_Model skill)
  • Skills reference use-case names instead of hardcoded model names

Task 8 — Remove Inline Model Quirks from Skills

Spec S7.3: “Model-specific quirk documentation is moved from inline skill procedures into the Choose_AI_Model skill’s model reference files.” Affected files: Forge/Skills/Forge_Optimizer/SKILL.md, Forge/Skills/Reindex_Typesense/SKILL.md, Forge/Skills/Typesense_MCP/SKILL.md. The model reference files were created in Plan 1 Task 2.

Steps

  1. Edit Forge/Skills/Forge_Optimizer/SKILL.md: remove inline model quirk documentation (model defaults and notes). Replace with a reference to the Choose_AI_Model skill’s model reference files: Forge/Skills/Choose_AI_Model/Models/.
  2. Edit Forge/Skills/Reindex_Typesense/SKILL.md: remove inline gpt-5.4-nano quirk documentation (the max_completion_tokens >= 300 and temperature parameter quirks). Replace with a reference to Forge/Skills/Choose_AI_Model/Models/gpt-5.4-nano.md.
  3. Edit Forge/Skills/Typesense_MCP/SKILL.md: remove inline gpt-5.4-nano and gpt-4o-mini quirk documentation. Replace with references to Forge/Skills/Choose_AI_Model/Models/gpt-5.4-nano.md and Forge/Skills/Choose_AI_Model/Models/gpt-4o-mini.md.

Verify

  • grep -r 'max_completion_tokens' Forge/Skills/Forge_Optimizer/SKILL.md Forge/Skills/Reindex_Typesense/SKILL.md Forge/Skills/Typesense_MCP/SKILL.md returns no matches
  • grep -r 'temperature.*parameter' Forge/Skills/Reindex_Typesense/SKILL.md Forge/Skills/Typesense_MCP/SKILL.md returns no matches (referring to the model quirk, not general usage)
  • Each affected skill references the Choose_AI_Model model reference files instead of inline quirks

Task 9 — Build, Commit, and Push

Spec S1.1–S1.8, S7.2, S7.3: This Plan implements skill file content corrections across all listed Spec sections. After all tasks are complete, commit and push the changes. Per Known Infrastructure Context, npm run build is expected to fail; proceed with git operations regardless.

Steps

  1. Run npm run build from the repo root. This is known to fail. Proceed regardless.
  2. git add all modified and renamed files: Forge/Skills/Agentic_Prompts/ (renamed from Orchestration), Forge/Skills/Update_Infrastructure/SKILL.md, Forge/Skills/Forge_Optimizer/SKILL.md, Forge/Skills/Create_Skill/SKILL.md, Forge/Skills/Linear_MCP/SKILL.md, Forge/Skills/Suprsend_MCP/SKILL.md, Forge/Skills/Vercel_MCP/SKILL.md, Forge/Skills/MCP_Development/SKILL.md, Forge/Skills/Git_Dashboard/SKILL.md, Forge/Skills/Home_Page/SKILL.md, Forge/Skills/Markdown_To_PDF/SKILL.md, Forge/Skills/Reindex_Typesense/SKILL.md, Forge/Skills/Typesense_MCP/SKILL.md, and any sidebar changes.
  3. git commit -m "Plan 2: Skill file content corrections (S1.1-S1.8, S7.2, S7.3)"
  4. git push origin dev

Verify

  • All modified files are committed and pushed to dev
  • git log --oneline -1 shows the commit

Plan 2 Completion Criteria

  • Orchestration skill renamed to Agentic_Prompts with updated description and no deprecation notice
  • Update_Infrastructure skill references uvilo-mono docs/deployment.md and repo structure, no “outdated” warning
  • No skill references Forge_Chat_Prompt.md
  • No skill references LibreChat or librechat.yaml; Vercel_MCP uses VERCEL_PROTECTION_BYPASS via /proc/1/environ
  • No skill references /workspace/erik/uvilo-os/
  • No skill references MongoDB or MongoDB/SKILL.md
  • Skills use use-case names instead of hardcoded model names (outside Choose_AI_Model)
  • Inline model quirks removed from Forge_Optimizer, Reindex_Typesense, and Typesense_MCP skills
  • Changes committed and pushed to dev

Dependencies

  • Requires: Plan 1 (model reference files must exist before removing inline quirks in Task 8)
  • Blocks: Plan 7 (skill rename must complete before updating Available Skills list)