Site profile skill

Site profile skill

This is the short public alias for:

• external-site-profile-learning

Also available as simpler aliases:

• profile
• 站点配置

Use this skill when you want to:

• add a new external site profile
• debug why a site works heuristically but fails under Gemini
• classify whether a site should be generic, blocked, special, or config-driven
• validate a site in both heuristic and Gemini modes

Primary guidance

Follow the same workflow as the full skill:

1. probe the site
2. classify the UI pattern and failure mode
3. add a data-only profile when justified
4. validate heuristic and Gemini flows
5. keep special/​rate-limited sites out of the default regression matrix
6. use grouped regression runs when debugging popup-heavy or heavy-page sites

Key rules

• Prefer URL or title verification for external sites.
• Prefer exact selectors over broad selectors.
• If a profile exists, normalize generated type and click steps back to the profile selectors.
• Treat login walls, hidden inputs, duplicate controls, and anti-bot behavior as different problem types.
• Prefer grouped validation commands such as validate:external:core, validate:external:popup, and validate:external:heavy for targeted debugging.

Quick invocation template

You do not need to use only /​site-profile.

Reliable invocation patterns include:

1. /​site-profile
2. use the site-profile skill
3. a natural-language request that clearly asks to turn an already-proven flow into a stable reusable profile

Use prompts like:

Use /​site-profile to turn this site into a stable external profile, then validate both heuristic and Gemini planning.

使用 /​site-profile 把这个网站沉淀成稳定 profile，并分别验证 heuristic 和 Gemini 两条链路。

Please turn this already-working site flow into a stable reusable profile and validate both heuristic and Gemini modes.

Output contract

The skill output should always include:

1. failure class or site class
2. exact selectors chosen and why
3. verification mode and expected signal
4. validation commands run (or planned)
5. final status: stable / blocked / special-case

Pointer

For the full detailed playbook, also see:

• skills/​external-site-profile-learning/​SKILL.md in this repository