gaokao-quick-advisor

Generates tiered college recommendations with admission probability estimates from gaokao scores.

11|2|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/legalskill/legalskill --skill gaokao-quick-advisor-legalskill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaokao-quick-advisor
Source: https://github.com/legalskill/legalskill/tree/main/skill/gaokao-quick-advisor
Command: npx skills add https://github.com/legalskill/legalskill --skill gaokao-quick-advisor-legalskill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Gaokao students and parents struggle to translate a raw exam score into a realistic list of universities. This Skill converts score, province, and subject category into a provincial rank, then produces reach/match/safety school recommendations with estimated admission probabilities based on historical admission rank data. ## Core Features & Use Cases - Score-to-Rank Conversion: Queries the Yuanbao API for one-score-one-segment tables and provincial cutoff lines, with local JSON data as fallback. - Three-Tier Recommendations: Classifies schools into reach (5-32%), match (32-68%), and safety (68%+) tiers using a logistic sigmoid probability model, with dynamic thresholds for junior-college scenarios. - Multi-Format Reports: Outputs a brief Markdown summary to stdout plus full Markdown, HTML, and JSON reports; on the IMA platform it auto-archives reports to the user's knowledge base. - Use Case: A user asks "What schools can I get into with 540 in Hebei physics track?" and immediately receives a ranked list of universities across three tiers with per-school admission probabilities and official website links. ## Quick Start Ask the assistant what universities you can apply to by stating your gaokao score, province, and subject category, such as "Hebei physics track 540 points, what schools can I get into?"

Frequently Asked Questions about gaokao-quick-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get college recommendations from my gaokao score?

Provide your score, province, and subject category (physics or history track) in natural language, such as "Hebei physics 540". The skill converts the score to a provincial rank and returns reach, match, and safety school lists with admission probabilities.

How is the admission probability for each university calculated?

Probabilities use a logistic sigmoid model with K=2.5, computed from the ratio between your provincial rank and each school's historical minimum admission rank. A ratio of 1.0 yields 50% probability; schools below 5% are excluded from recommendations.

Which provinces does this gaokao recommendation tool support?

All 31 provinces, municipalities, and autonomous regions in mainland China are covered, including both undergraduate and junior college tiers. Hebei uses 2025 data while other provinces currently rely on 2024 admission data.

Does the recommendation work when the Yuanbao API is unavailable?

Only partially. Hebei province falls back to local one-score-one-segment JSON data, but other provinces depend on the Yuanbao API for rank conversion and cutoff lines, so recommendations may fail for them without API access.

What are the limitations of the admission probability estimates?

Probabilities are logistic model approximations based on historical rank data, not guarantees. Actual admission depends on that year's applicant distribution, enrollment plan changes, and major popularity, so results are reference-only and exclude sorting advice.