Skip to content

docs: update agent skills docs#25

Merged
yi-ge merged 1 commit into
mainfrom
codex/docs-agent-skill-sync
Jul 7, 2026
Merged

docs: update agent skills docs#25
yi-ge merged 1 commit into
mainfrom
codex/docs-agent-skill-sync

Conversation

@yi-ge

@yi-ge yi-ge commented Jul 7, 2026

Copy link
Copy Markdown
Member

Summary

Updates Agent, Skills, and Marketplace documentation based on recent v10.0.46-v10.0.82 product changes.

  • documents project-level skills, .agents/skills, .claude/skills, skill export, localization, and SKILL_DIR resource references
  • adds clone/sync and team version-control pages with English mirrors
  • updates marketplace and skill pack docs for install targets, registry/pointer behavior, app/service integration, and team distribution

Stack

Base: codex/docs-capability-tools.

Validation

  • npm run typecheck
  • npm run build

@vercel

vercel Bot commented Jul 7, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 7, 2026 12:17pm

Request Review

@yi-ge yi-ge marked this pull request as ready for review July 7, 2026 12:23
Copilot AI review requested due to automatic review settings July 7, 2026 12:24
Base automatically changed from codex/docs-capability-tools to main July 7, 2026 12:27
@yi-ge yi-ge merged commit e19a527 into main Jul 7, 2026
5 checks passed
@yi-ge yi-ge deleted the codex/docs-agent-skill-sync branch July 7, 2026 12:27

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Agent/Skills/Marketplace documentation to reflect recent product changes, and adds new user-guide pages for cloning/syncing agents and team-level version control (with English mirrors).

Changes:

  • Add new “Clone and Sync” and “Team Version Control” docs in both docs/ (ZH) and i18n/en/ (EN).
  • Expand Skills docs to cover project-level skills directories (.agents/skills, .claude/skills), export, localization, and ${SKILL_DIR} references.
  • Update Marketplace docs to describe registry/pointer behavior and installation targets.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/10-team-version-control.md Adds EN mirror page for team version control.
i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/09-clone-and-sync.md Adds EN mirror page for clone/sync behavior.
docs/02-user-guide/09-capabilities/04-skill-packs.md Documents additional skill entry paths (project injection/auto-injection) and ${SKILL_DIR} usage.
docs/02-user-guide/06-agents/10-team-version-control.md Adds new ZH page describing team-level Git hosting/releases/distribution.
docs/02-user-guide/06-agents/09-clone-and-sync.md Adds new ZH page describing clone modes, private-data scope, and conflict handling.
docs/02-user-guide/06-agents/08-version-control.md Adds sync/conflict-resolution section and links out to clone/team docs.
docs/02-user-guide/06-agents/07-skills-management.md Adds install targets, source priority, export, localization, and resource-reference guidance.
docs/02-user-guide/06-agents/06-agent-files.md Documents skill_permissions.json, skill references/scripts, and project-level skill locations.
docs/02-user-guide/06-agents/02-marketplace.md Updates Marketplace positioning and adds registry/pointer + install-flow details (incl. app/service catalog link).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 66 to +70
3. 等待下载和配置完成
4. 安装成功后,在对话页面切换到新智能体即可开始使用

Skill 安装时可以选择全局安装或安装到指定智能体。应用安装后,可能会派生出服务条目,并进入 [应用与服务目录](../capabilities/app-service-catalog) 管理。

Comment on lines +64 to 68
安装 Skill 时可以选择安装目标:全局、指定智能体,或项目级目录。全局市场技能安装后会写入全局技能目录,所有智能体都能发现;绑定到智能体的技能会写入对应智能体仓库;项目级 Skill 只在对应工作目录下生效,适合把团队规范、项目脚本和本地模板随项目一起维护。

### 移除技能

### 本地导入
Comment on lines +137 to 142
- [Clone 与同步](./clone-and-sync) — 复制智能体,选择是否复制私有数据,并处理后续同步
- [团队版本管理](./team-version-control) — 团队远程托管、fork、release 和市场分发

## 下一步

- [团队版本管理](./09-team-version-management.md) — 把整支智能体团队当作一个整体进行版本管理
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants