Agent skill

Improve Idea Critique

by assafkip in assafkip/kipi-system

Judges a pasted tip, post or video summary against what the kipi system already has, and returns adopt, skip or already-built with the files that back the verdict.

MITAuto-check passedAgent Workflows

Install Improve Idea Critique

skills CLI
$ npx skills add assafkip/kipi-system --skill improve -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install assafkip/kipi-system improve --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/assafkip/kipi-system.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/kipi-core/skills/improve .claude/skills/improve && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
improve
GitHub stars
112
Token cost
~729 tokens
SKILL.md length
349 words
Files
3 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Judges a pasted tip, post or video summary against what the kipi system already has, and returns adopt, skip or already-built with the files that back the verdict.

  • Works in 2 steps: Deterministic (this skill must run it,… → Judgment (the skill): read what the…
  • Deciding whether a tip from a post or transcript is worth adopting
  • SKILL.md covers The two halves, Hard constraint, Do not and Changelog
  • Runs Python scripts from its folder; calls python3

What it does

The skill runs in two halves. First it must run scripts/improve_ground.py with a target type such as rule, hook, trigger, skill or prompt and the idea in one sentence. The script prints a JSON verdict with citations to lessons paths or named files, plus a report of which lessons directories were read, missing or unreadable. It exits 0 for already-built or adopt and 2 for skip, and the KIPI_LESSONS_CORPORA variable adds more corpora to check against.

Second, the agent opens what the script cited and writes a short critique: the idea restated as a change to the system, what already covers it with the exact line, and a verdict. An already-built verdict names the file, adopt names the smallest change and a check that would prove it, and skip gives the classifier's reason. Ideas about what to build, sell, price, publish or advise a client are always skipped. The agent must not cite from memory, widen the trigger or read a corpus reported as missing.

When your agent uses it

  • Deciding whether a tip from a post or transcript is worth adopting
  • Checking whether a suggested rule or hook already exists in your setup
  • Comparing an outside idea against the lessons your system has recorded
  • Getting a grounded adopt or skip verdict instead of an opinion

Example prompts

  • “Improve: should we add a pre-commit hook that blocks commits without a ticket number?”
  • “Here is a video summary about context pruning. Compare this to what we have.”
  • “Should we do this? A post says every skill needs a changelog line per edit.”
  • “Run improve on this pasted tip about scheduling a weekly review job.”

Requirements

  • Python 3 to run improve_ground.py
  • The kipi-core plugin with its lessons corpora

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Deterministic (this skill must run it, never reason from memory)
  2. Judgment (the skill): read what the script cited. Then write the

What it can do on your machine

Read from SKILL.md and the folder at commit 17583bd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Improve Idea Critique loads about 729 tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 349 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~729

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from assafkip/kipi-system at commit 17583bd, republished under its MIT licence (© assafkip). 349 words, ~729 tokens.

Download SKILL.mdSave it as .claude/skills/improve/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
improve
description
Critique an outside idea (a pasted tip, post, transcript or video summary) against what this system already has. Use when the founder pastes something and asks whether to adopt it, or says 'improve', 'should we do this', 'compare this to what we have'. Grounded by scripts/improve_ground.py in the lessons corpora and named files; returns adopt, skip, or already-built, and NEVER decides what to build, sell or publish.

Improve: an outside idea, judged against the system that exists

Plan item 2d of the morning-brief overhaul (Bloom's improve pass). The founder pastes an idea. This skill answers one question: does it change how the SYSTEM works, and is that change already here?

The two halves

  1. Deterministic (this skill must run it, never reason from memory):

    bash
    python3 plugins/kipi-core/skills/improve/scripts/improve_ground.py --target <rule|lint|hook|trigger|context|skill|prompt|test|script|job> "<idea in one sentence>"

    It prints a JSON verdict with cites (lessons paths or named files) and a corpora report saying which lessons directories were read, missing or unreadable. Exit 0 for already-built / adopt, 2 for skip. Set KIPI_LESSONS_CORPORA=/path/one:/path/two to ground against more than this instance's corpus; the report names each one either way.

  2. Judgment (the skill): read what the script cited. Then write the critique in this shape:

    • The idea, in one sentence, as a SYSTEM change (a stage, a trigger, a rule, a context entry). If it cannot be phrased that way it is roadmap, and the verdict is skip regardless of how good the idea is.
    • What already exists: the cited file or lesson, opened, with the line that covers it. Not "we have something like that".
    • Verdict: already-built (name the file), adopt (name the smallest change and the check that would prove it), or skip (name the reason the classifier gave).
Show full SKILL.md (140 more words)Show less

Hard constraint

This skill fixes the system. It never decides the roadmap. An idea about what to build, sell, price, publish or advise a client returns skip from the script (roadmap_scope.py, fail-closed on unknown) and the skill does not override that with judgment. If the founder wants the product conversation, that is a conversation, not this skill.

Do not

  • Cite from memory. If the script's cites is empty the verdict is not a verdict; say so.
  • Widen the trigger. This is on-demand only; it never rides the brief or the weekly pass.
  • Read a corpus the report says is missing. Say it is missing.

Changelog

  • 2026-09-01: created (prd-morning-brief-learns, issue mbl-improve-skill). Verdicts cite a lessons path or a named file; corpora contract via KIPI_LESSONS_CORPORA; roadmap ideas skip by classifier, never by judgment; one line per entry because test_skill_changelog.py reads each line.

© assafkip, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in plugins/kipi-core/skills/improve of assafkip/kipi-system.

  • SKILL.md
  • scripts/improve_ground.py
  • scripts/test_improve_ground.py

Open the folder on GitHubat commit 17583bd

Compare with similar skills

Improve Idea Critique next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Improve Idea Critique compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Improve Idea Critique this skillassafkip/kipi-system112—~729Automated safety check: PassMIT
Mspm0 Ccsmc3545dada/mspm0-skill374—~4.5kAutomated safety check: PassMIT
Generate AI Rulesdivar-ir/ai-doc-gen765—~1.2kAutomated safety check: PassMIT
Goal Prompt Builderwin4r/goal-prompt-builder228—~3.1kAutomated safety check: PassMIT
Requirement Ledger CLI Workflowadand-91/gpt-6-astra-skill125—~1.5kAutomated safety check: PassMIT
Analyze Codebasedivar-ir/ai-doc-gen765—~899Automated safety check: PassMIT

Similar skills

  • Mspm0 Ccs

    mc3545dada/mspm0-skill

    Tool-neutral CLI agent rules for TI MSPM0 development with Code Composer Studio, Keil/uVision, CMake/GCC/OpenOCD, SysConfig, and DriverLib.

    374 GitHub stars~4.5k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Generate AI Rules

    divar-ir/ai-doc-gen

    Generate AI assistant configuration files for a repository — CLAUDE.md, AGENTS.md, and Cursor rules (.cursor/rules/.mdc) — from codebase analysis.

    765 GitHub stars~1.2k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Goal Prompt Builder

    win4r/goal-prompt-builder

    Build high-quality /goal commands for OpenAI Codex CLI 0.128+ that maximize audit-friendliness and minimize false-completion.

    228 GitHub stars~3.1k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • Requirement Ledger CLI Workflow

    adand-91/gpt-6-astra-skill

    Runs an evidence-bound audit, daily or weekly review through the requirement-ledger CLI, binding scope and authority first and blocking the final report until a handoff check passes.

    125 GitHub stars~1.5k tokensUpdated 21 days ago
    Agent WorkflowsAuto-check passed
  • Analyze Codebase

    divar-ir/ai-doc-gen

    Run a multi-agent deep analysis of a codebase, producing AI-readable analysis documents in .ai/docs/ covering structure, dependencies, data flow, request flow, and APIs.

    765 GitHub stars~899 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Lintlang

    hermes-labs-ai/lintlang

    Lint AI agent instruction files (SKILL.md, CLAUDE.md, AGENTS.md, GEMINI.md), tool definitions, system prompts, and agent configs with the deterministic LintLang CLI.

    137 GitHub stars~1.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from assafkip/kipi-system

All 14 skills in this repo
  • Deck AI

    assafkip/kipi-system

    Turns a markdown file into a themed, image-rich slide deck exported as PDF, using Slidev for layouts and Unsplash for photos, all run locally.

    112 GitHub stars~1.5k tokensUpdated today
    Auto-check: notes
  • Unified Design Router

    assafkip/kipi-system

    Routes visual design requests to built-in logo, corporate identity, slide, banner, social photo and icon workflows, backed by style data and AI image generation.

    112 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Fable Discipline

    assafkip/kipi-system

    Teaches staged, verifiable coding habits for multi-file tasks and ships a hook that blocks tests from touching live data.

    112 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Root-Cause Analysis Writer

    assafkip/kipi-system

    Writes a structured, blameless root-cause analysis for a defect that escaped a test or gate, separating surface from structural causes and linting the result.

    112 GitHub stars~796 tokensUpdated today
    Auto-check passed
  • Architecture Review

    assafkip/kipi-system

    Surfaces architectural friction in real code — shallow modules, tight coupling, untested seams — and proposes deepening refactors using Ousterhout's deep-module principle (small interface hiding a…

    112 GitHub stars~817 tokensUpdated today
    Auto-check passed
  • Audhd Executive Function

    assafkip/kipi-system

    AUDHD executive function accommodations. An agent skill from assafkip/kipi-system.

    112 GitHub stars~3.3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Improve Idea Critique

What does Improve Idea Critique do?

Judges a pasted tip, post or video summary against what the kipi system already has, and returns adopt, skip or already-built with the files that back the verdict. The skill runs in two halves.py with a target type such as rule, hook, trigger, skill or prompt and the idea in one sentence.

When should I use Improve Idea Critique?

Improve Idea Critique fits situations like: deciding whether a tip from a post or transcript is worth adopting; checking whether a suggested rule or hook already exists in your setup; comparing an outside idea against the lessons your system has recorded; getting a grounded adopt or skip verdict instead of an opinion.

How do I install Improve Idea Critique in Claude Code?

Run `npx skills add assafkip/kipi-system --skill improve -a claude-code`. Or copy the skill folder (plugins/kipi-core/skills/improve in assafkip/kipi-system) into .claude/skills/improve in your project. Claude Code loads it when a task matches its description.

How do I install Improve Idea Critique in Codex?

Run `npx skills add assafkip/kipi-system --skill improve -a codex`. Or copy the skill folder (plugins/kipi-core/skills/improve in assafkip/kipi-system) into .agents/skills/improve in your project. Codex loads it when a task matches its description.

Can I use Improve Idea Critique in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add assafkip/kipi-system --skill improve -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/improve, .gemini/skills/improve, .github/skills/improve and .opencode/skills/improve in your project.

What does Improve Idea Critique need to run?

Going by SKILL.md and its folder, Improve Idea Critique needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3 to run improve_ground.py; The kipi-core plugin with its lessons corpora.

Does Improve Idea Critique access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Improve Idea Critique safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Improve Idea Critique use?

Improve Idea Critique is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Improve Idea Critique use?

About 729 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Improve Idea Critique?

Skills that share tags, products or a category with Improve Idea Critique: Mspm0 Ccs (mc3545dada/mspm0-skill, 374 stars), Generate AI Rules (divar-ir/ai-doc-gen, 765 stars), Goal Prompt Builder (win4r/goal-prompt-builder, 228 stars) and Requirement Ledger CLI Workflow (adand-91/gpt-6-astra-skill, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Improve Idea Critique?

assafkip (a GitHub user) maintains it in assafkip/kipi-system, which has 112 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

Source: assafkip/kipi-system on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.