docs: Document skill marketplace publishing

Clarify that marketplace-facing skill links track the default branch while runtime artifacts use release tags. Add release checklist steps for GitHub topics, skills.re, SkillHub, and SkillsMP verification.

Author: Colvin-Y

README.md

@@ -122,6 +122,10 @@ You can also install from the repository root and select the skill by name:
 npx skills add Colvin-Y/kubernetes-ontology -s kubernetes-ontology-access -g --agent codex
 ```
 
+Skill marketplace links intentionally point at the default branch so agents get
+the latest onboarding instructions. Use tagged releases for runtime binaries,
+container images, and Helm chart versions.
+
 Restart Codex after installing the skill, then ask for a guided setup, for
 example:
 
@@ -516,6 +520,10 @@ Tagged releases publish:
 
 See [docs/release.md](docs/release.md) for the release checklist.
 
+The agent skill is published from the default branch rather than from release
+archives, so marketplace pages should link to the live repository path:
+`skills/kubernetes-ontology-access`.
+
 ## Known Limitations
 
 - Graph state is in memory only.

README.zh-CN.md

@@ -90,6 +90,9 @@ npx skills add https://github.com/Colvin-Y/kubernetes-ontology/tree/main/skills/
 npx skills add Colvin-Y/kubernetes-ontology -s kubernetes-ontology-access -g --agent codex
 ```
 
+Skill marketplace 对外链接故意指向默认分支，这样 Agent 会拿到最新的接入
+说明。运行时二进制、镜像和 Helm Chart 版本仍然使用发布 tag。
+
 安装后重启 Codex，然后可以这样提问：
 
 ```text

docs/release.md

@@ -129,6 +129,58 @@ Query it with the release CLI:
 kubernetes-ontology --server http://127.0.0.1:18080 --status
 ```
 
+## Publish The Agent Skill
+
+The skill is distributed from the repository default branch, not from release
+archives. Keep marketplace pages pointed at the live repository path so users
+get the newest onboarding workflow:
+
+```text
+https://github.com/Colvin-Y/kubernetes-ontology/tree/main/skills/kubernetes-ontology-access
+```
+
+For each release:
+
+1. Keep `skills/kubernetes-ontology-access/SKILL.md` metadata aligned with the
+   release you are documenting.
+2. Push the skill and README changes to the default branch before refreshing
+   marketplace entries.
+3. Ensure GitHub repository topics include:
+
+   ```text
+   claude-skills
+   claude-code-skill
+   agent-skills
+   codex-skills
+   kubernetes
+   devops
+   troubleshooting
+   ```
+
+   With an authenticated GitHub CLI:
+
+   ```bash
+   gh repo edit Colvin-Y/kubernetes-ontology \
+     --add-topic claude-skills \
+     --add-topic claude-code-skill \
+     --add-topic agent-skills \
+     --add-topic codex-skills
+   ```
+
+4. Refresh the manually submitted registries:
+
+   - `https://skills.re/submit`: submit the repository URL and select
+     `skills/kubernetes-ontology-access`.
+   - `https://skillhub.pm/submit`: submit as a Skill in the DevOps &
+     Infrastructure category.
+
+5. SkillsMP has no manual submit flow yet. It indexes GitHub daily, so verify
+   after the next sync:
+
+   ```bash
+   curl -fsS 'https://skillsmp.com/api/v1/skills/search?q=kubernetes-ontology-access&limit=10'
+   ```
+
 ## Optional Docker Hub Mirror
 
 If you later want Docker Hub as an additional mirror:

skills/README.md

@@ -24,5 +24,9 @@ Or install from the repository and select this skill:
 npx skills add Colvin-Y/kubernetes-ontology -s kubernetes-ontology-access -g --agent codex
 ```
 
+These install commands are meant to track the repository's default branch.
+Release tags are used for the daemon, CLI, viewer binaries, images, and Helm
+chart versions; the skill itself should expose the latest onboarding workflow.
+
 Restart Codex after installing the skill. If the onboarding flow needs the
 repository checkout, the skill will guide the user to clone it at that point.

skills/kubernetes-ontology-access/README.md

@@ -23,6 +23,11 @@ npx skills add Colvin-Y/kubernetes-ontology -s kubernetes-ontology-access -g --a
 
 Restart your agent after installation so it discovers the new skill.
 
+These marketplace-facing commands intentionally track the repository's default
+branch. Use the latest release tag for daemon, CLI, viewer, image, and Helm
+runtime versions, but let the skill content follow the newest onboarding
+workflow.
+
 ## Usage
 
 Example prompts: