Agent skill

Devcodex Workspace

by devcodex-labs in devcodex-labs/devcodex

A skill your agent uses when cwd belongs to a DevCodex workspace, the user asks for DevCodex behavior, OR the user message may match a workspace custom skill under .devcodex/workspace/skills (short…

AGPL-3.0Auto-check passed

Install Devcodex Workspace

skills CLI
$ npx skills add devcodex-labs/devcodex --skill devcodex-workspace -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install devcodex-labs/devcodex devcodex-workspace --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/grok/plugins/devcodex-workspace/skills/devcodex-workspace .claude/skills/devcodex-workspace && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
devcodex-workspace
GitHub stars
439
Token cost
~1.6k tokens
SKILL.md length
694 words
Files
1
Skills in repo
70
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses when cwd belongs to a DevCodex workspace, the user asks for DevCodex behavior, OR the user message may match a workspace custom skill under .devcodex/workspace/skills (short…

  • Works in 6 steps: Before treating a short user message as… → If a route is committed, load only that… → Privacy / process UI: 禁止列出或扫描用户主目录下的宿主… → …
  • Cwd belongs to a DevCodex workspace
  • SKILL.md covers Unified Workspace Skill…, HostParity (vs Codex) —… and GrokTurnChecklist +…
  • Calls npm

What it does

Devcodex Workspace is an agent skill from devcodex-labs/devcodex. Use when cwd belongs to a DevCodex workspace, the user asks for DevCodex behavior, OR the user message may match a workspace custom skill under .devcodex/workspace/skills (short triggers like skill name/id, quoted phrases in skill description, e.g. test/测试). Prefer workspace skill fixed behavior over connectivity/chat defaults.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts. The licence is AGPL-3.0.

When your agent uses it

  • Cwd belongs to a DevCodex workspace
  • The user asks for DevCodex behavior
  • The user message may match a workspace custom skill under .devcodex/workspace/skills (short triggers like skill name/id
  • Quoted phrases in skill description

Example prompts

  • “/devcodex-workspace”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Before treating a short user message as connectivity ping / Ready, use the bounded catalog supplied by the unified route; do not…
  2. If a route is committed, load only that one SKILL.md through skill_route and obey it for the turn. Do not invent Ready/闲聊.
  3. Privacy / process UI: 禁止列出或扫描用户主目录下的宿主 skill 树,例如
  4. 过程文案用「正在加载 技能」,不要写「命中…正在读取并按该技能执行」。
  5. CLI inventory verify: devcodex skill resolve ; route regression: npm run test:skill-route.
  6. Do not claim UPS inject on Grok. Recover stale route metadata, preserve pending work and continue available actions.

What it can do on your machine

Read from SKILL.md and the folder at commit 1dd4525. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Devcodex Workspace loads about 1.6k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 694 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from devcodex-labs/devcodex at commit 1dd4525, republished under its AGPL-3.0 licence (© devcodex-labs). 694 words, ~1,582 tokens.

Download SKILL.mdSave it as .claude/skills/devcodex-workspace/SKILL.md (or your agent's skills folder).
name
devcodex-workspace
description
Use when cwd belongs to a DevCodex workspace, the user asks for DevCodex behavior, OR the user message may match a workspace custom skill under .devcodex/workspace/skills (short triggers like skill name/id, quoted phrases in skill description, e.g. test/测试). Prefer workspace skill fixed behavior over connectivity/chat defaults.

DevCodex Workspace Resolver

Grok UserPromptSubmit cannot inject model context (stdout ignored). Workspace custom skills are not native-scanned; DevCodex uses the same staged skill_route contract as the other hosts: build a bounded W + managed G catalog, commit at most one route, and load only the committed stage body. Stop reports workflow and wording gaps as advisory; it does not force repeated model turns. The plugin is user-global and does not own a workspace. Resolve the nearest workspace-namespace marker from cwd, keep task state under that workspace's .devcodex, and load shared instructions/Skills from user-global DevCodex surfaces plus the committed workspace skill. Full-evidence route: devcodex grok.

Unified Workspace Skill Route(用户可见闭环)

  1. Before treating a short user message as connectivity ping / Ready, use the bounded catalog supplied by the unified route; do not independently scan skill trees.
  2. If a route is committed, load only that one SKILL.md through skill_route and obey it for the turn. Do not invent Ready/闲聊.
  3. Privacy / process UI: 禁止列出或扫描用户主目录下的宿主 skill 树,例如
    C:\Users\…\.grok\skills、~\.grok\bundled\skills、~\.claude\skills、~\.agents\skills(L1)。
    这些 List 会把 C 盘用户路径暴露在过程时间线里。全局 skill 只读
    ~/.agents/devcodex/skills/<id>/SKILL.md 单文件;工作区 skill 只读
    .devcodex/workspace/skills/<id>/SKILL.md。
  4. 过程文案用「正在加载 <id> 技能」,不要写「命中…正在读取并按该技能执行」。
  5. CLI inventory verify: devcodex skill resolve <id>; route regression: npm run test:skill-route.
  6. Do not claim UPS inject on Grok. Recover stale route metadata, preserve pending work and continue available actions.

HostParity (vs Codex) — honesty contract

TierRouteGuaranteesMust not claim
Fulldevcodex grok (official --rules kernel bind)Controlling AGENTS.md in context; host-owned tool permissions; path-observable context and unified staged skill route; workflow/Stop diagnosticsUserPromptSubmit context inject; forced continuation from wording gaps; verified PC0 from Hook payload alone
Partialplain grok in a child Git projectBest-effort Skill discovery + advisory plugin bridge when reachableFull host parity with Codex; kernelInjected=true from passive Hook stdout

Platform facts (Grok Build hooks docs): PreToolUse and Stop/SubagentStop can hard-control; UserPromptSubmit is passive (no inject). PC5 must report Partial unless Full launcher evidence is present. Do not equate Grok with Codex UPS inject bootstrap.

  1. Preserve the semantic intent seed before reading project context.
  2. Bind the nearest valid workspace-namespace root from cwd. Do not require or create workspace AGENTS.md, .agents, .grok, .codex, .claude, .gemini, or .github.
  3. Resolve the project namespace relative to that workspace and bind runtime state under .devcodex/<project>/.
  4. Follow the kernel's intent-first route and read only selected files from the managed global runtime plus the resulting workspace Profile/context plan, and the single workspace skill committed by skill_route.
  5. Use ~/.agents/devcodex/instructions.full.md only for an explicit fallback; workspace .devcodex remains the sole workspace-owned DevCodex surface.
  6. Before substantive output, satisfy UserVisibleReplyLayoutV1 + UserVisibleNoisePolicyV1 (six-host shared): emit plain-language PC0~PC10; show completion checks only when claiming completion. Runtime cannot inject on Grok; models still own S07.
  7. Optional assist: call MCP profile_compose_entry_check for PC0~PC10; missing template/receipt details are repaired while continuing the original task.
  8. Run devcodex doctor / devcodex status and read hostParity (HostParityScorecardV1): full-capable means hard path is ready; still use devcodex grok for Full session kernel evidence. partial lists failedChecks and executable repairSteps (commands); re-run doctor after each fix.
  9. Execute GrokTurnChecklist every non-trivial turn (PF-165 + C16/PI-20260724-01): PC0~PC10 → Intent→Skill mandatory bundle → ContextReadPlan → scan-hygiene → TTFV first delivery → work/gates → report+memory → honest platform ceiling. Never skip S05/S07/C17 because inject is missing.
  10. Workspace skill trigger: if user message matches a W skill, obey that skill before checklist bulk for chat-like turns.
Show full SKILL.md (147 more words)Show less

GrokTurnChecklist + Intent→Skill bundle (PF-165)

StepMust do
entry-pc0-pc10Full PC0~PC10 first; re-emit after compact/resume
intent-routeFinal route before loading workflow Skills
skill-bundleNon-chat mandatory: intent + compliance + user-visible-output-contract + workflow Skill + report + memory (minimal-sufficient; no full Skill encyclopedia preload)
context-planBounded plan/receipts only
scan-hygieneWorkspaceRootScanHygiene: prefer a bound project path and exclude node_modules/dist; Hook telemetry is advisory and the host owns permission
ttfv-first-deliveryTimeToFirstValueGate: same user-visible turn delivers scope card OR first findings/conclusion OR hard block (non-chat)
work-and-gatesCP/ECR as applicable
report-memoryNon-chat write report + memory
honest-ceilingNo inject / forced Stop loops / Grok===Codex claims; preserve pending facts and continue available work

Machine source: scripts/lib/host-parity-scorecard.js (GROK_TURN_EXECUTION_CHECKLIST, classifyWorkspaceRootScanSample, classifyTtfvOmissionSample, repairSteps). Site doc: public-site/docs/reference/hosts.md.

The plugin is a discovery adapter, not a second rules source. Its passive Hook output must never be presented as kernel-injection evidence. Do not copy AGENTS.md, CLAUDE.md, GEMINI.md, .agents, .github, .grok, .codex, .claude, or .gemini into a workspace.

© devcodex-labs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in grok/plugins/devcodex-workspace/skills/devcodex-workspace of devcodex-labs/devcodex.

Open the folder on GitHubat commit 1dd4525

Compare with similar skills

Devcodex Workspace next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Devcodex Workspace compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Devcodex Workspace this skilldevcodex-labs/devcodex439—~1.6kAutomated safety check: PassAGPL-3.0
Cwd Rolluphoangsonww/Claude-Code-Agent-Monitor1k1 repos~648Automated safety check: PassMIT
Belonging Classroom Culture DesignerGarethManning/education-agent-skills830—~6.2kAutomated safety check: PassCustom licence
Figma Extractnexu-io/open-design100k—~606Automated safety check: PassApache-2.0
Code Importnexu-io/open-design100k—~597Automated safety check: PassApache-2.0
SPA Routes and Featureslobehub/lobehub83k—~3.2kAutomated safety check: PassCustom licence

Similar skills

  • Cwd Rollup

    hoangsonww/Claude-Code-Agent-Monitor

    Roll up Claude Code sessions by working directory (project) from Agent Monitor data — session count, total cost, total tokens, and last-active timestamp per cwd — so per-project activity can be…

    1k GitHub starsUsed in 1 repo~648 tokens
    Auto-check passed
  • Belonging Classroom Culture Designer

    GarethManning/education-agent-skills

    Design targeted interventions that strengthen belonging and inclusion for specific classroom dynamics.

    830 GitHub stars~6.2k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Figma Extract

    nexu-io/open-design

    Pull a Figma file's node tree, design tokens, and embedded assets into the project cwd as a structured snapshot.

    100k GitHub stars~606 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Code Import

    nexu-io/open-design

    Read an existing repository's structure into the project cwd as a normalised snapshot the agent can analyse without re-walking the tree on every turn.

    100k GitHub stars~597 tokensUpdated today
    DevelopmentAuto-check passed
  • Explains LobeHub's split between src/routes page segments and src/features domain code, and where router config, redirects and platform adapters belong.

    83k GitHub stars~3.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Rules for deciding whether a pull request without an explicit changelog marker belongs in the release changelog, and under which category.

    65k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed

More from devcodex-labs/devcodex

All 70 skills in this repo
  • Accessibility I18n

    devcodex-labs/devcodex

    无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用;要求把包容性体验和本地化验证绑定到真实用户路径。

    439 GitHub stars~718 tokensUpdated 20 days ago
    Auto-check passed
  • AI Agent System Architecture

    devcodex-labs/devcodex

    AI Agent 系统架构专家 Owner — 当任务涉及 Agent 路由、工具调用、上下文管理、记忆、状态机、权限、人机协作、可观测性、回放验证或模型辅助治理时使用;要求把 Agent 行为设计成可解释、可恢复、可审计。

    439 GitHub stars~2.4k tokensUpdated 20 days ago
    Auto-check passed
  • API Contract Architecture

    devcodex-labs/devcodex

    API 契约架构专家 Owner — 当任务涉及 public API、HTTP/SDK/CLI 契约、版本兼容、错误模型、分页过滤、幂等、Schema、类型、迁移或消费者影响时使用;要求先冻结消费者契约,再设计实现与验证。

    439 GitHub stars~865 tokensUpdated 20 days ago
    Auto-check passed
  • Architecture Design

    devcodex-labs/devcodex

    架构设计文档编排 Owner — 当用户要求架构设计、系统设计、技术架构或可指导开发、Review 与任务拆分的完整方案时使用;要求从业务流程反推节点、状态、数据、一致性、异常补偿、ADR 与实施任务。

    439 GitHub stars~1.1k tokensUpdated 20 days ago
    Auto-check passed
  • Audit Common

    devcodex-labs/devcodex

    审查公共维度 G0~G5 + Profile Freshness Check — 所有 audit 子类型必先执行的基础维度层

    439 GitHub stars~4.1k tokensUpdated 20 days ago
    Auto-check passed
  • Audit Session

    devcodex-labs/devcodex

    审计工作流的跨会话状态机 — 在 <audit-root/.audit-state/<session-id.json 持久化轮次/发现项/收敛状态,支持 Token 中断后精准恢复

    439 GitHub stars~1.8k tokensUpdated 20 days ago
    Auto-check passed

Questions about Devcodex Workspace

What does Devcodex Workspace do?

A skill your agent uses when cwd belongs to a DevCodex workspace, the user asks for DevCodex behavior, OR the user message may match a workspace custom skill under .devcodex/workspace/skills (short…. Devcodex Workspace is an agent skill from devcodex-labs/devcodex.g.

When should I use Devcodex Workspace?

Devcodex Workspace fits situations like: cwd belongs to a DevCodex workspace; the user asks for DevCodex behavior; the user message may match a workspace custom skill under .devcodex/workspace/skills (short triggers like skill name/id; quoted phrases in skill description.

How do I install Devcodex Workspace in Claude Code?

Run `npx skills add devcodex-labs/devcodex --skill devcodex-workspace -a claude-code`. Or copy the skill folder (grok/plugins/devcodex-workspace/skills/devcodex-workspace in devcodex-labs/devcodex) into .claude/skills/devcodex-workspace in your project. Claude Code loads it when a task matches its description.

How do I install Devcodex Workspace in Codex?

Run `npx skills add devcodex-labs/devcodex --skill devcodex-workspace -a codex`. Or copy the skill folder (grok/plugins/devcodex-workspace/skills/devcodex-workspace in devcodex-labs/devcodex) into .agents/skills/devcodex-workspace in your project. Codex loads it when a task matches its description.

Can I use Devcodex Workspace in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add devcodex-labs/devcodex --skill devcodex-workspace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/devcodex-workspace, .gemini/skills/devcodex-workspace, .github/skills/devcodex-workspace and .opencode/skills/devcodex-workspace in your project.

What does Devcodex Workspace need to run?

Going by SKILL.md and its folder, Devcodex Workspace needs the command-line tools its instructions call (npm).

Does Devcodex Workspace access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Devcodex Workspace safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Devcodex Workspace use?

Devcodex Workspace is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Devcodex Workspace use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Devcodex Workspace?

Skills that share tags, products or a category with Devcodex Workspace: Cwd Rollup (hoangsonww/Claude-Code-Agent-Monitor, 1k stars), Belonging Classroom Culture Designer (GarethManning/education-agent-skills, 830 stars), Figma Extract (nexu-io/open-design, 100k stars) and Code Import (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Devcodex Workspace?

devcodex-labs (a GitHub organization) maintains it in devcodex-labs/devcodex, which has 439 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on September 17, 2026.

Source: devcodex-labs/devcodex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.