Agent skill

Devcodex Workspace

by devcodex-labs in devcodex-labs/devcodex

A skill your agent uses for non-trivial work in a DevCodex workspace and whenever a task may match a managed or workspace Skill.

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/cursor/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
~554 tokens
SKILL.md length
285 words
Files
1
Skills in repo
70
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses for non-trivial work in a DevCodex workspace and whenever a task may match a managed or workspace Skill.

  • Works in 8 steps: Before substantive work, follow the… → Resolve the nearest valid DevCodex… → Use devcodex-profile skill_route in this… → …
  • Non-trivial work in a DevCodex workspace and whenever a task may match a managed
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Workspace Skill

What it does

Devcodex Workspace is an agent skill from devcodex-labs/devcodex. Use for non-trivial work in a DevCodex workspace and whenever a task may match a managed or workspace Skill. Resolve intent first, then use the staged devcodex-profile skillroute contract instead of scanning every Skill.

Its SKILL.md is about 550 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

  • Non-trivial work in a DevCodex workspace and whenever a task may match a managed
  • Workspace Skill

Example prompts

  • “/devcodex-workspace”

Workflow steps

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

  1. Before substantive work, follow the session-injected DevCodex kernel and
  2. Resolve the nearest valid DevCodex workspace namespace from the current
  3. Use devcodex-profile skill_route in this order: bounded catalog, one commit,
  4. A successful stage load is the evidence that the selected Skill body is
  5. Use devcodex-memory for CP receipts, task memory and summaries. Do not treat
  6. After compaction, re-run the entry contract and refresh context binding
  7. Cursor local IDE, interactive CLI, Headless CLI and Cloud Agent have separate
  8. Do not create .cursor, AGENTS.md, CLAUDE.md, GEMINI.md, .agents or other host

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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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 554 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 285 words of instructions outside code blocks.

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

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). 285 words, ~554 tokens.

Download SKILL.mdSave it as .claude/skills/devcodex-workspace/SKILL.md (or your agent's skills folder).
name
devcodex-workspace
description
Use for non-trivial work in a DevCodex workspace and whenever a task may match a managed or workspace Skill. Resolve intent first, then use the staged devcodex-profile skill_route contract instead of scanning every Skill.

DevCodex Workspace Resolver for Cursor

Cursor loads this small resolver from the user-global DevCodex Plugin. It is a discovery adapter, not a second rules or state source.

  1. Before substantive work, follow the session-injected DevCodex kernel and emit the required PC0 through PC7 entry check.
  2. Resolve the nearest valid DevCodex workspace namespace from the current working directory. Keep project runtime state only under that workspace's .devcodex namespace.
  3. Use devcodex-profile skill_route in this order: bounded catalog, one commit, then load only the committed stage. Do not recursively list user Skill directories or load the entire Skill corpus. Cursor does not expose dynamic context from an allowed beforeSubmitPrompt response. Never invent project, turnBinding, contextEpoch, generation or planDigest values. If preToolUse denies a tool and supplies an agent_message with Next call (exact), execute that exact action before unrelated work; the shorter user_message is only a human-facing reason.
  4. A successful stage load is the evidence that the selected Skill body is active. A catalog entry or native Skill listing alone is not load evidence.
  5. Use devcodex-memory for CP receipts, task memory and summaries. Do not treat Cursor approval mode as DevCodex CP or automatic authorization.
  6. After compaction, re-run the entry contract and refresh context binding before unrelated work.
  7. Cursor local IDE, interactive CLI, Headless CLI and Cloud Agent have separate evidence. Never copy a local readiness claim to Cloud.
  8. Do not create .cursor, AGENTS.md, CLAUDE.md, GEMINI.md, .agents or other host adapter files inside a business workspace. The Plugin and Hooks are user-global.

If the Hook adapter is unavailable, this Skill is guidance only. Report the native state as UNVERIFIED and use devcodex status or devcodex doctor for the single next recovery step.

© 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 cursor/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—~554Automated safety check: PassAGPL-3.0
Agent Self Evaluationaffaan-m/ECC274k—~1.9kAutomated safety check: PassMIT
PR Triagewannabespace/conar1.5k—~811Automated safety check: PassAGPL-3.0
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
System Change Engineeringbytedance/deer-flow83k—~2.5kAutomated safety check: PassMIT
Workflow Authoringasgeirtj/system_prompts_leaks69k—~7.5kAutomated safety check: PassCC0-1.0

Similar skills

  • Use after completing any non-trivial task. An agent skill from affaan-m/ECC.

    274k GitHub stars~1.9k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • PR Triage

    wannabespace/conar

    Speed up a GitHub PR review — sort every changed file into trivial / skim / review, mark the trivial ones as viewed on GitHub, and hand back a reading order for the rest.

    1.5k GitHub stars~811 tokensUpdated today
    DatabasesAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • System Change Engineering

    bytedance/deer-flow

    Evaluates and carries out non-trivial software changes from first principles: ground the problem, name real consumers, choose the smallest sufficient solution and require evidence.

    83k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Workflow Authoring

    asgeirtj/system_prompts_leaks

    A skill your agent uses when authoring a non-trivial Workflow for research, review, migration, or other multi-agent work, especially when the task needs multiple evidence sources, verification, or…

    69k GitHub stars~7.5k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Phased workflow for non-trivial qwen-code features: investigate, design doc, E2E test plan, baseline dry-run, implement, verify, self-audit, review and iterate.

    28k GitHub stars~1.2k tokensUpdated today
    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 for non-trivial work in a DevCodex workspace and whenever a task may match a managed or workspace Skill. Devcodex Workspace is an agent skill from devcodex-labs/devcodex. Use for non-trivial work in a DevCodex workspace and whenever a task may match a managed or workspace Skill.

When should I use Devcodex Workspace?

Devcodex Workspace fits situations like: non-trivial work in a DevCodex workspace and whenever a task may match a managed; workspace Skill.

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 (cursor/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 (cursor/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?

SKILL.md names no scripts, command-line tools or credentials: Devcodex Workspace is instructions for the agent only.

Does Devcodex Workspace access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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 554 tokens (SKILL.md is roughly 2.2k 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: Agent Self Evaluation (affaan-m/ECC, 274k stars), PR Triage (wannabespace/conar, 1.5k stars), PR Design Doc (OpenHands/OpenHands, 90k stars) and System Change Engineering (bytedance/deer-flow, 83k 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.