HK IPO Parameter Manager

Save, inspect, activate, and compare Hong Kong IPO scoring parameter versions across weights, thresholds, and cost assumptions. Use when the user wants to tu...

Security Scan

The skill is internally consistent: it bundles a CLI runtime for HK IPO parameter management, asks for the expected local DB path and a small runtime dependency, and its code and instructions align with the described purpose.

Purpose & Capability

Name/description (parameter versioning and comparison) match the delivered artifacts: a CLI 'hkipo-next' with params commands and a declared config DB (~/.hkipo-next/data/hkipo.db). Requiring 'uv' to run the included runtime is proportionate to the install/run approach.

Instruction Scope

SKILL.md instructs running the bundled runtime via 'uv run --directory runtime/hkipo-next hkipo-next ...' and refers to the local sqlite DB. The runtime code performs web requests to public IPO data sources (expected for scoring/comparison) and reads/writes its own data store. There are no instructions to read unrelated system files or to export secrets.

Install Mechanism

Install spec uses a Homebrew formula 'uv' which is a reasonable, low-risk mechanism compared to arbitrary downloads. Verify that the 'uv' formula being installed is the intended package on your platform (name is short/uncommon, so confirm it maps to the expected CLI runner). The bundle itself contains Python code (no remote extract from unknown URLs).

Credentials

No environment variables or external credentials are required. The single required config path (~/.hkipo-next/data/hkipo.db) is consistent with a stateful parameter manager. Network access to public data sources is part of functionality and does not require secrets.

Persistence & Privilege

always is false; the skill does not request forced or global persistence. It creates/uses a local DB under the user's home directory only, which is appropriate for storing parameter versions.

Assessment

This skill appears to be what it says: a bundled CLI for managing HK IPO scoring parameters that stores state in ~/.hkipo-next/data/hkipo.db and fetches public IPO data from several websites. Before installing: 1) Confirm the Homebrew 'uv' formula is the intended runner on your system (name is short/uncommon). 2) Back up any existing ~/.hkipo-next/data/hkipo.db to avoid accidental overwrite. 3) Expect the tool to make outbound HTTP(S) requests to public data sources (aipo.myiqdii.com, aastocks, hkex endpoints, etc.); run it in a network-limited environment if you need to audit traffic first. 4) If you want to be extra cautious, inspect runtime/hkipo-next source files locally (they are bundled) or run the CLI in a sandbox/VM before granting access to your main environment.

Use this skill for stateful scoring-rule management.

Runtime

This publish bundle includes the required CLI runtime under runtime/hkipo-next.

From the skill folder:

cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next ...

By default parameter versions are stored in ~/.hkipo-next/data/hkipo.db.

Parameter Model

• Weights: snapshot-quality-weight, affordability-weight, pricing-stability-weight, sponsor-support-weight, cost-efficiency-weight
• Thresholds: participate-min, cautious-min
• Costs: handling-fee-hkd, financing-rate-annual-pct, cash-opportunity-rate-annual-pct, lockup-days

Workflow

1. Inspect current versions with params list or params show.
2. Save new candidates instead of mutating old versions.
3. Activate a version only when the user wants it to become the new default.
4. Compare candidate versions on a representative symbol before broad rollout.

Commands

List versions:

cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next params list --format json

Show the active version:

cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next params show --format json

Save and activate a tuned version:

cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next params save \
  --name conservative-margin \
  --sponsor-support-weight 0.20 \
  --cost-efficiency-weight 0.25 \
  --participate-min 78 \
  --cautious-min 62 \
  --lockup-days 6 \
  --notes "Bias toward sponsor quality and lower carrying cost" \
  --activate \
  --format json

Compare two versions:

cd <skill_dir>
uv run --directory runtime/hkipo-next hkipo-next params compare 2476 v0002 v0003 --format json

Output Cues

• active_version is the default version used by later scoring commands.
• action_changed in compare output tells you whether a tuning change would alter the recommendation.
• factor_deltas shows which factor scores moved between versions.

Companion Skills

• Use $hkipo-decision-engine after an active version is ready.
• Use $hkipo-review-optimizer when tuning changes come from real-world review feedback.