improve-ic-skill

Improves existing skills in the IC Skills repo through targeted edits and eval updates.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/phukrit7171/Relationship-Smart-Contract-ICP --skill improve-ic-skill-phukrit7171
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve-ic-skill
Source: https://github.com/phukrit7171/Relationship-Smart-Contract-ICP/tree/main/.agents/skills/improve-ic-skill
Command: npx skills add https://github.com/phukrit7171/Relationship-Smart-Contract-ICP --skill improve-ic-skill-phukrit7171

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Improving an existing skill without a clear problem statement leads to unfocused edits, broken evals, and regressions. This Skill enforces a disciplined workflow for updating skills in the IC Skills repo (skills.internetcomputer.org): understand the specific issue first, change precisely, and verify only what changed. ## Core Features & Use Cases - Problem-first gating: Refuses to start work until a specific issue is identified, preventing blind edits that risk breaking working content. - Targeted improvement areas: Guides updates to pitfalls, canister IDs, code examples, descriptions, and required frontmatter, with special handling for upstream-tracked skills like motoko and mops-cli. - Eval management: Seeds new eval files for skills lacking them, updates cases affected by changes, and runs only relevant eval subsets with baseline comparisons. - Use Case: A maintainer reports that the ckbtc skill's description never triggers. Use this Skill to diagnose the description, rewrite it with trigger keywords, add trigger evals, and run them with baseline before opening a PR. ## Quick Start Ask the assistant to improve a specific skill in the IC Skills repo by stating the exact problem, such as fixing a stale canister ID or adding a missing pitfall to the motoko skill.

Frequently Asked Questions about improve-ic-skill

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

FAQPage Schema
How do I improve an existing skill in the IC Skills repo?

Start with a specific problem statement such as a stale canister ID or missing pitfall, then read the skill, validate the baseline with npm run validate, apply focused edits, and update evals. Vague requests are rejected to prevent unfocused changes.

How do I update evals when changing a skill?

Edit evaluations/<skill-name>.json at the repo root whenever you add a pitfall, change a command or canister ID, or introduce new behavior. Run every added or changed case with baseline using node scripts/evaluate-skills.js <skill-name> --eval <N>.

Can I use this skill to create a brand-new skill?

No, this skill is only for improving existing skills at skills/<skill-name>/SKILL.md. For creating a new skill from scratch, use the skill-creator skill instead.

What are upstream-tracked skills in the IC Skills repo?

Skills like motoko, migrating-motoko, migrating-motoko-enhanced, and mops-cli sync from an upstream source. Check .claude/upstream.md before editing; only icskills-owned sections can be changed freely, and shared content fixes should be filed upstream.

Why does the skill refuse to start without a specific issue?

Blind improvements risk changing content that works fine and introducing regressions. A concrete problem statement ensures edits stay focused and evals verify only what actually changed.

When should I re-run existing eval cases after editing a skill?

Re-run existing cases when you changed content they explicitly test, rewrote sections they cover, or significantly changed the description (trigger evals only). Skip cases covering untouched content to save tokens.