# 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

```bash
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:

```bash
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.