skill-open-sourcer
Audit, package, add, verify, and publish local Agent Skills through the canonical zjp1997720/zhijian-skills portfolio. Use when the user gives a SKILL.md or Skill directory and asks to open-source, publish, release, share, validate, manage versions, make installable with npx skills, prepare documentation, or generate launch copy. Every public Skill must live in the canonical repository's nested skills directory; never create or update a standalone Skill repository.
zjp1997720 · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add zjp1997720/zhijian-skills --skill skill-open-sourcer技能说明
name: skill-open-sourcer description: Audit, package, add, verify, and publish local Agent Skills through the canonical zjp1997720/zhijian-skills portfolio. Use when the user gives a SKILL.md or Skill directory and asks to open-source, publish, release, share, validate, manage versions, make installable with npx skills, prepare documentation, or generate launch copy. Every public Skill must live in the canonical repository's nested skills directory; never create or update a standalone Skill repository.
Skill Open Sourcer
Publish every public Skill from the single canonical repository: https://github.com/zjp1997720/zhijian-skills.
Hard publishing boundary
- A
SKILL.mdpath or Skill directory is an import candidate, not a request to create a repository. - Put the complete agent payload in
skills/<name>/, human docs indocs/skills/<name>/, and release notes indocs/changelogs/<name>.md. - Register the Skill in
registry/skills.json. Never addmirror,mirror_tag, standalone repository, redirect workflow, or mirror-export metadata. - Publish commits, per-Skill Tags, and install instructions only from
zjp1997720/zhijian-skills. - Stop on secrets, private paths, client data, unpublished proprietary material, unclear asset ownership, or an unverified canonical remote.
Read Portfolio mode, Registry contract, Release package, and README design before writing.
Workflow
- Resolve the input to a real Skill directory. Accept a
SKILL.md, its containing directory, or a symlink from a local Skill root. - Resolve the canonical checkout from the current repository,
ZHIJIAN_SKILLS_REPO, or~/Documents/GitHub/zhijian-skills. Verifyoriginresolves tozjp1997720/zhijian-skills; never guess another destination. - Follow the canonical repository's Git synchronization rules. Run
git_sync_guard.py check --repo <zhijian-skills>before changing or publishing from an existing checkout; aneeds-syncmarker is a hard stop. Then run:
SKILL_OPEN_SOURCER_DIR="<zhijian-skills>/skills/skill-open-sourcer"
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/check_release_env.py" \
--repo-dir <zhijian-skills> --check-npx-skills
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/scan_skill_release.py" \
/path/to/skill-or-SKILL.md
- Inspect
SKILL.mdand directly referencedagents/,references/,scripts/, andassets/. Copy only the complete, sanitized install payload intoskills/<name>/; preserve required license and third-party notices. - Write the eight-field release story from README design, choose
clean-docorproof-led, then create or update bilingual docs, Changelog, Registry record, Portfolio catalog, and project-native visuals. A proof-led Hero must use a composition derived from the Skill's real mechanism or output; changing only the title and motif inside a shared layout fails review. Never expose a root-levelSKILL.mdor add human README files inside the Skill payload. - Choose the version with version-contract.md. Use only the canonical Tag
<skill>/v<version>. - Freeze a release plan with the narrowest selector. For a governed Skill, its
manifest.jsonmust declaretrust_reportandoutput_quality_scorecardas files inside the install payload; both files must exist and be tracked atHEAD. Planning fails before candidate refs are created when either baseline is undeclared, missing, untracked, or escapes the payload. Use--skill <name>for one Skill; reserve--alland optional--excludefor an intentional multi-Skill wave:
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/release_portfolio.py" plan \
--repo <zhijian-skills> --source-checkout <original-checkout> \
--skill <name> --dry-run \
--plan-out /tmp/<name>-release-plan.json
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/release_portfolio.py" verify \
--plan /tmp/<name>-release-plan.json
--skill and --all are mutually exclusive. Repeat --skill only when the user explicitly authorizes a small multi-Skill release. Do not combine --skill with --exclude.
The plan records the live origin/main SHA with git ls-remote. verify queries it again and fails when it changed. When --repo is a temporary clean clone, --source-checkout must identify the original checkout; planning marks that checkout release-in-progress and installs a pre-commit guard so it cannot create new commits from the stale base.
- Validate the Skill, declared tests, full Portfolio, documentation, and repository contracts:
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/portfolio.py" \
validate-skill <zhijian-skills>/skills/<name>
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/portfolio.py" \
audit --repo <zhijian-skills> --strict
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/audit_release_readme.py" \
--repository-root <zhijian-skills> \
<zhijian-skills>/docs/skills/<name>/README.md \
<zhijian-skills>/docs/skills/<name>/README.zh-CN.md --strict
python3 -m unittest discover -s <zhijian-skills>/tests -v
When README assets are generated by the Portfolio, regenerate them and run the asset tests before accepting the diff. Render every changed Hero at 900px and 360px; deterministic checks do not replace visual inspection.
- Verify local
npx skillsdiscovery, then run one fail-fast isolated copy install from the canonical repository:
python3 "$SKILL_OPEN_SOURCER_DIR/scripts/verify_isolated_install.py" \
--repo <zhijian-skills> --skill <name>
The verifier isolates HOME, uses copy mode, and compares SHA-256 manifests byte-for-byte. It returns non-zero immediately when preflight, installation, materialization, missing/extra files, or content comparison fails; do not append a success-printing command that can mask its exit code. Listing success alone is insufficient. Use top-l
阅读完整来源 ↗