How do I install the Contextarchitect skill?

Run npx skillmds@latest add tomevault-io/contextarchitect in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Contextarchitect safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Contextarchitect?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Contextarchitect free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Contextarchitect?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Contextarchitect by tomevault-io — Agent Skill

Name: Contextarchitect
Author: tomevault-io

Contextarchitect

Audit and optimize agent context files across Claude Code and OpenAI Codex. Covers CLAUDE.md, AGENTS.md, rules, skills, and memory organization. USE WHEN "optimize context" OR "audit setup" OR "context architecture" OR "where should this go" OR "reduce duplication" OR "context budget" OR "too many tokens" OR "reorganize rules" OR "skill hierarchy" OR "CLAUDE.md too big" OR "AGENTS.md too big" OR "optimize skills". Based on Gloaguen et al. 2026 research, Anthropic best practices, and OpenAI Codex docs. Use when this capability is needed.

tomevault-io 38b34ad 2 files · 2.9 KB Updated Sep 17, 2026

File contents

ContextArchitect

Analyzes your entire agent context setup — across both Claude Code (CLAUDE.md, .claude/) and OpenAI Codex (AGENTS.md, .codex/) — at user and project levels. Identifies duplication, bloat, misplaced content, and cross-agent inconsistencies.

Workflow Routing

Workflow	Trigger	File
Audit	"audit setup", "optimize skills", "check my organization"	`Workflows/Audit.md`
Placement	"where should this go", "user or project level"	`Workflows/Placement.md`

Context Files

Principles.md — Research-backed principles (Gloaguen paper, Anthropic docs, OpenAI Codex docs, community patterns)

Examples

Example 1: Full audit

User: "audit my skill setup"
-> Scans ~/.claude/, ~/.codex/, and project-level files
-> Checks for duplication, bloat, misplaced content, cross-agent drift
-> Outputs prioritized recommendations with exact file moves

Example 2: Placement decision

User: "I have a code review workflow -- where should it live?"
-> Asks: project-specific rules? Used across all repos? Which agents?
-> Recommends user-level skill vs project-level rule
-> Shows exact directory path and template

Example 3: Cross-agent consistency check

User: "are my Claude and Codex configs in sync?"
-> Compares ~/.claude/CLAUDE.md with ~/.codex/AGENTS.md
-> Flags drift between the two
-> Recommends single source of truth pattern (stow-managed)

Source: RooseveltAdvisors/claude-agent-stack — distributed by TomeVault.

---name: contextarchitectdescription: Audit and optimize agent context files across Claude Code and OpenAI Codex. Covers CLAUDE.md, AGENTS.md, rules, skills, and memory organization. USE WHEN "optimize context" OR "audit setup" OR "context architecture" OR "where should this go" OR "reduce duplication" OR "context budget" OR "too many tokens" OR "reorganize rules" OR "skill hierarchy" OR "CLAUDE.md too big" OR "AGENTS.md too big" OR "optimize skills". Based on Gloaguen et al. 2026 research, Anthropic best practices, and OpenAI Codex docs. Use when this capability is needed.---# ContextArchitectAnalyzes your entire agent context setup — across both **Claude Code** (`CLAUDE.md`, `.claude/`) and **OpenAI Codex** (`AGENTS.md`, `.codex/`) — at user and project levels. Identifies duplication, bloat, misplaced content, and cross-agent inconsistencies.## Workflow Routing| Workflow | Trigger | File ||----------|---------|------|| **Audit** | "audit setup", "optimize skills", "check my organization" | `Workflows/Audit.md` || **Placement** | "where should this go", "user or project level" | `Workflows/Placement.md` |## Context Files- `Principles.md` — Research-backed principles (Gloaguen paper, Anthropic docs, OpenAI Codex docs, community patterns)## Examples**Example 1: Full audit**```User: "audit my skill setup"-> Scans ~/.claude/, ~/.codex/, and project-level files-> Checks for duplication, bloat, misplaced content, cross-agent drift-> Outputs prioritized recommendations with exact file moves```**Example 2: Placement decision**```User: "I have a code review workflow -- where should it live?"-> Asks: project-specific rules? Used across all repos? Which agents?-> Recommends user-level skill vs project-level rule-> Shows exact directory path and template```**Example 3: Cross-agent consistency check**```User: "are my Claude and Codex configs in sync?"-> Compares ~/.claude/CLAUDE.md with ~/.codex/AGENTS.md-> Flags drift between the two-> Recommends single source of truth pattern (stow-managed)```---> Source: [RooseveltAdvisors/claude-agent-stack](https://github.com/RooseveltAdvisors/claude-agent-stack) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions