Align agent skill structure with DexSim

skills/add-atomic-action/SKILL.md → .agents/skills/add-atomic-action/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-atomic-action
-description: Use when adding a new observation, event, reward, action, dataset, or randomization functor to an EmbodiChain environment
+description: Use when adding a new simulation atomic action or motion primitive to EmbodiChain's AtomicActionEngine.
 ---
 
 # Add Atomic Action

.agents/skills/add-atomic-action/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: add-atomic-action
+canonical_skill: .agents/skills/add-atomic-action/SKILL.md
+project: EmbodiChain
+

.agents/skills/add-functor/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: add-functor
+canonical_skill: .agents/skills/add-functor/SKILL.md
+project: EmbodiChain
+

.agents/skills/add-task-env/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: add-task-env
+canonical_skill: .agents/skills/add-task-env/SKILL.md
+project: EmbodiChain
+

.agents/skills/add-test/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: add-test
+canonical_skill: .agents/skills/add-test/SKILL.md
+project: EmbodiChain
+

.agents/skills/benchmark/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: benchmark
+canonical_skill: .agents/skills/benchmark/SKILL.md
+project: EmbodiChain
+

skills/pr/SKILL.md → .agents/skills/pr/SKILL.md

@@ -80,9 +80,7 @@ Commit with a clear message following conventional commits format:
 ```bash
 git commit -m "type(scope): brief description
 
-Detailed description of the change.
-
-Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>"
+Detailed description of the change."
 ```
 
 ### 7. Push to Remote
@@ -168,8 +166,6 @@ Fixes #<issue-number>
 - [ ] I have made corresponding changes to the documentation
 - [ ] I have added tests that prove my fix is effective or that my feature works
 - [ ] Dependencies have been updated, if applicable.
-
-🤖 Generated with [Claude Code](https://claude.com/claude-code)
 ```
 
 ## PR Title Guidelines
@@ -199,4 +195,3 @@ Fixes #<issue-number>
 - Keep PRs small and focused. Large PRs are harder to review and merge.
 - It's recommended to open an issue and discuss the design before opening a large PR.
 - The checklist in the PR template should be completed honestly.
-- Remember to include the Claude Code attribution at the bottom of the PR body.

.agents/skills/pr/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: pr
+canonical_skill: .agents/skills/pr/SKILL.md
+project: EmbodiChain
+

.agents/skills/pre-commit-check/agents/openai.yaml

@@ -0,0 +1,4 @@
+name: pre-commit-check
+canonical_skill: .agents/skills/pre-commit-check/SKILL.md
+project: EmbodiChain
+

skills/project-dev-context/SKILL.md → .agents/skills/project-dev-context/SKILL.md

@@ -21,6 +21,8 @@ Use this skill when:
 ## Start here
 
 - Read `agent_context/MAP.yaml` first
+- Read `references/context-system.md` for routing rules
+- Read `agents/openai.yaml` for the canonical agent metadata
 - Read `agent_context/conventions/*.md` when creating or updating context files
 
 ## Workflow
@@ -58,6 +60,9 @@ If code behavior changes a routed topic, update all relevant pieces in the same
 - the matching file under `agent_context/topics/...`
 - `agent_context/MAP.yaml` if topic metadata changed
 - `AGENTS.md` if routing guidance changed
+- `.agents/skills/project-dev-context/references/context-system.md` if routing behavior changed
+- `.claude/skills/project-dev-context/SKILL.md` if Claude adapter wording changed
+- `.github/copilot/project-dev-context.md` if Copilot adapter wording changed
 
 ## Source-of-truth
 

.agents/skills/project-dev-context/agents/openai.yaml

@@ -0,0 +1,3 @@
+name: project-dev-context
+canonical_skill: .agents/skills/project-dev-context/SKILL.md
+project: EmbodiChain

.agents/skills/project-dev-context/references/context-system.md

@@ -0,0 +1,26 @@
+# EmbodiChain Agent Context System
+
+EmbodiChain keeps agent-facing context in `agent_context/`, indexed by
+`agent_context/MAP.yaml`. Agent skills are stored under `.agents/skills/`.
+Claude Code project adapters use `.claude/skills/<skill>/SKILL.md`, and
+GitHub Copilot adapters under `.github/copilot/` should stay thin.
+
+## Routing Rules
+
+1. Read `agent_context/MAP.yaml` first.
+2. Resolve the requested topic by exact `id`, then `aliases`, then `keywords`.
+3. Load only the matched Markdown files listed in the topic `paths`.
+4. Do not read `docs/source/` unless the user explicitly asks for Sphinx
+   documentation.
+
+## Update Rules
+
+When behavior covered by a context topic changes, update the topic Markdown and
+`agent_context/MAP.yaml` metadata in the same change. If routing behavior itself
+changes, update:
+
+- `.agents/skills/project-dev-context/SKILL.md`
+- `.agents/skills/project-dev-context/references/context-system.md`
+- `AGENTS.md`
+- `.claude/skills/project-dev-context/SKILL.md`
+- `.github/copilot/project-dev-context.md`

.claude/skills/add-atomic-action/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: add-atomic-action
+description: Claude adapter for the canonical EmbodiChain add-atomic-action skill.
+---
+
+# Add Atomic Action - Claude Adapter
+
+Canonical source: `.agents/skills/add-atomic-action/`
+
+## When to use
+
+- adding a new atomic action
+- creating a custom motion primitive
+- extending `AtomicActionEngine`
+
+## Start here
+
+1. Use this adapter when the task asks for a new atomic action.
+2. Then follow `.agents/skills/add-atomic-action/SKILL.md`.
+

.claude/skills/add-functor/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: add-functor
+description: Claude adapter for the canonical EmbodiChain add-functor skill.
+---
+
+# Add Functor - Claude Adapter
+
+Canonical source: `.agents/skills/add-functor/`
+
+## When to use
+
+- adding observation, reward, event, action, dataset, or randomization functors
+- scaffolding manager terms
+- extending manager configuration with `FunctorCfg`
+
+## Start here
+
+1. Use this adapter when the task asks for a new functor.
+2. Then follow `.agents/skills/add-functor/SKILL.md`.
+

.claude/skills/add-task-env/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: add-task-env
+description: Claude adapter for the canonical EmbodiChain add-task-env skill.
+---
+
+# Add Task Env - Claude Adapter
+
+Canonical source: `.agents/skills/add-task-env/`
+
+## When to use
+
+- creating a new EmbodiChain task environment
+- adding an `EmbodiedEnv` subclass
+- scaffolding a new registered Gym task
+
+## Start here
+
+1. Use this adapter when the task asks for a new task environment.
+2. Then follow `.agents/skills/add-task-env/SKILL.md`.
+

.claude/skills/add-test/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: add-test
+description: Claude adapter for the canonical EmbodiChain add-test skill.
+---
+
+# Add Test - Claude Adapter
+
+Canonical source: `.agents/skills/add-test/`
+
+## When to use
+
+- writing tests for EmbodiChain modules
+- adding coverage for new public APIs
+- preparing PR validation
+
+## Start here
+
+1. Use this adapter when the task asks for tests.
+2. Then follow `.agents/skills/add-test/SKILL.md`.
+

.claude/skills/benchmark/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: benchmark
+description: Claude adapter for the canonical EmbodiChain benchmark skill.
+---
+
+# Benchmark - Claude Adapter
+
+Canonical source: `.agents/skills/benchmark/`
+
+## When to use
+
+- writing benchmark scripts
+- modifying benchmark workflow
+- comparing solver, simulator, or toolkit performance
+
+## Start here
+
+1. Use this adapter when the task is benchmark-specific.
+2. Then follow `.agents/skills/benchmark/SKILL.md`.
+

.claude/skills/pr/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: pr
+description: Claude adapter for the canonical EmbodiChain PR skill.
+---
+
+# PR - Claude Adapter
+
+Canonical source: `.agents/skills/pr/`
+
+## When to use
+
+- drafting or creating an EmbodiChain pull request
+- filling the GitHub PR template
+- selecting repository labels
+
+## Start here
+
+1. Use this adapter when the task asks for PR preparation or creation.
+2. Then follow `.agents/skills/pr/SKILL.md`.
+

.claude/skills/pre-commit-check/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: pre-commit-check
+description: Claude adapter for the canonical EmbodiChain pre-commit-check skill.
+---
+
+# Pre-Commit Check - Claude Adapter
+
+Canonical source: `.agents/skills/pre-commit-check/`
+
+## When to use
+
+- checking changes before commit or PR
+- running local CI-style validation
+- verifying headers, formatting, annotations, exports, tests, and docs
+
+## Start here
+
+1. Use this adapter when the task asks for pre-commit validation.
+2. Then follow `.agents/skills/pre-commit-check/SKILL.md`.
+

.claude/skills/project-dev-context/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: project-dev-context
+description: Claude adapter for the canonical EmbodiChain project-dev-context skill.
+---
+
+# Project Dev Context - Claude Adapter
+
+Canonical source: `.agents/skills/project-dev-context/`
+
+## When to use
+
+- reference project development docs
+- reference project context
+- refresh project context
+- update project context
+- write project context
+- register a new project context topic
+- 参考项目开发文档
+- 参考项目上下文
+- 刷新项目上下文
+- 更新项目上下文
+- 写项目上下文
+
+## Start here
+
+1. Use this adapter when the request asks to reference, refresh, write, or register project development context.
+2. Then follow `.agents/skills/project-dev-context/SKILL.md`.
+3. Resolve topics through `agent_context/MAP.yaml`.
+
+## Update contract
+
+Keep this file thin. If canonical routing behavior changes, update the
+canonical skill first, then only adjust this adapter if Claude needs a
+different local entry hint.
+

.github/copilot/add-atomic-action.md

@@ -0,0 +1,8 @@
+# Add Atomic Action for GitHub Copilot
+
+Canonical source: `.agents/skills/add-atomic-action/`
+
+Use this adapter when adding a new EmbodiChain atomic action, custom motion
+primitive, or `AtomicActionEngine` extension. Then follow
+`.agents/skills/add-atomic-action/SKILL.md`.
+

.github/copilot/add-functor.md

@@ -0,0 +1,7 @@
+# Add Functor for GitHub Copilot
+
+Canonical source: `.agents/skills/add-functor/`
+
+Use this adapter when adding observation, reward, event, action, dataset, or
+randomization functors. Then follow `.agents/skills/add-functor/SKILL.md`.
+

.github/copilot/add-task-env.md

@@ -0,0 +1,7 @@
+# Add Task Env for GitHub Copilot
+
+Canonical source: `.agents/skills/add-task-env/`
+
+Use this adapter when creating a new EmbodiChain task environment or registered
+`EmbodiedEnv` subclass. Then follow `.agents/skills/add-task-env/SKILL.md`.
+

.github/copilot/add-test.md

@@ -0,0 +1,7 @@
+# Add Test for GitHub Copilot
+
+Canonical source: `.agents/skills/add-test/`
+
+Use this adapter when writing tests for EmbodiChain modules or adding coverage
+for new public APIs. Then follow `.agents/skills/add-test/SKILL.md`.
+

.github/copilot/benchmark.md

@@ -0,0 +1,7 @@
+# Benchmark for GitHub Copilot
+
+Canonical source: `.agents/skills/benchmark/`
+
+Use this adapter when writing or modifying EmbodiChain benchmark scripts. Then
+follow `.agents/skills/benchmark/SKILL.md`.
+

.github/copilot/instructions.md

@@ -0,0 +1,19 @@
+# EmbodiChain Agent Instructions for GitHub Copilot
+
+EmbodiChain keeps canonical agent skills under `.agents/skills/`.
+
+## Project Context Routing
+
+Use `.github/copilot/project-dev-context.md` as the local entry adapter, then
+follow the canonical routing rules in `.agents/skills/project-dev-context/`.
+
+## Common Skills
+
+- Add task environments: `.github/copilot/add-task-env.md`
+- Add functors: `.github/copilot/add-functor.md`
+- Add atomic actions: `.github/copilot/add-atomic-action.md`
+- Add tests: `.github/copilot/add-test.md`
+- Run pre-commit checks: `.github/copilot/pre-commit-check.md`
+- Draft or create pull requests: `.github/copilot/pr.md`
+- Write benchmarks: `.github/copilot/benchmark.md`
+

.github/copilot/pr.md

@@ -0,0 +1,8 @@
+# EmbodiChain PR Creation for GitHub Copilot
+
+Canonical source: `.agents/skills/pr/`
+
+Use this adapter when drafting or creating an EmbodiChain pull request, filling
+the GitHub PR template, or selecting repository labels. Then follow
+`.agents/skills/pr/SKILL.md`.
+

.github/copilot/pre-commit-check.md

@@ -0,0 +1,7 @@
+# Pre-Commit Check for GitHub Copilot
+
+Canonical source: `.agents/skills/pre-commit-check/`
+
+Use this adapter before committing or opening a PR. Then follow
+`.agents/skills/pre-commit-check/SKILL.md`.
+