skill-lib/VERIFY.md

VERIFY

Use this checklist when validating the skill_lib repository.

Structural Checks

• All runtime packages live under skill_lib/skills/.
• Each skill package contains a SKILL.md or SKILL.toml plus a maintained SKILL.md.
• Each current skill package contains a references/ directory.
• Each current skill package contains an assets/ directory.
• Long operational detail lives in references/, not only in SKILL.md.
• Preserved remote source artifacts live in assets/.
• Browser extraction skills that promise structured output use scripts/ when a deterministic script is required.
• Browser skills define blocked/login/captcha behavior explicitly instead of reporting only "no data".
• Downstream export/presentation skills consume upstream artifacts instead of recollecting browser data.

Repository Scope Checks

• This repository does not contain Rust runtime dispatch code.
• This repository does not contain browser transport implementation code.
• This repository does not copy the original remote Rust modules into the skill packages.
• The repository is a skill description library, not a runtime executable.

Package Inventory

Current packages:

• zhihu-navigate
• zhihu-write
• zhihu-hotlist
• zhihu-hotlist-screen
• office-export-xlsx

Recommended Commands

find /home/zyl/projects/sgClaw/skill_lib/skills -mindepth 2 -maxdepth 2 -name SKILL.md | sort
find /home/zyl/projects/sgClaw/skill_lib/skills -type d \( -name references -o -name assets \) | sort
rg -n "^name: |^description: |^version: |^author: |^tags:" /home/zyl/projects/sgClaw/skill_lib/skills/*/SKILL.md
python3 /home/zyl/projects/sgClaw/claw/scripts/validate_skill_lib.py

From /home/zyl/projects/sgClaw/claw, run the project-local unit test suite:

python3 -m unittest tests.skill_lib_validation_test -v
python3 -m unittest tests.skill_script_hotlist_extractor_test -v

Expected Outcome

• Exactly five active skill packages exist.
• Each package has both references/ and assets/.
• Each maintained skill document exposes the standardized frontmatter keys used by this repository.
• The project-local validator reports PASS for all active packages.
• Browser-script packages pass their dedicated script-level regression tests.

Known Caveat

• skills/zhihu-hotlist/assets/zhihu_hotlist_flow.source.json was reconstructed from an earlier successful source fetch because the remote endpoint timed out during the final implementation batch. Its content matches the previously captured remote flow used in analysis.