Individual skill
schliff
Deterministic linter and scorer for instruction files — SKILL.md, AGENTS.md, CLAUDE.md. No model in the loop: the same bytes score the same everywhere. Use for linting, scoring, auditing or CI-gating an instruction file, and for checking whether the commands a file promises actually resolve in the repo. Trigger phrases: "lint my skill", "score my skill", "audit skill", "review my skill", "harden skill", "make this skill better", "optimize my skill", "improve [metric] from X to Y", "benchmark skill", "check my AGENTS.md", "is my AGENTS.md lying", or paste a SKILL.md for auto-analysis. Also use when a user shares an instruction file without explicit instructions. Do NOT use for authoring a file from scratch — use a skill-creator first, then schliff. Do NOT use for application-code linting, SQL tuning, or runtime behaviour testing.
skills/schliff/SKILL.md
Source commit 32fc4fc8414ac6b7ebfd748ae70c628a81f9e8c2
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 6, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 18
- Repository last updated
- Nov 8, 2026
- License
- MIT
Observed agent integration: codex
- autoresearch Repository topic
- claude-code Repository topic
- cli Repository topic
- developer-tools Repository topic
- linter Repository topic
- python Repository topic
- ai-agents Repository topic
- claude Repository topic
- deterministic Repository topic
- code-quality Repository topic
- data Derived category
- security Derived category
- testing Derived category
- data-databases Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 5,065 bytes__init__.pyruns · 92 byteseval-suite.jsonasset · 25,667 byteshooks/hooks.jsonasset · 407 byteshooks/session-injector.jsruns · 5,832 bytesreferences/improvement-protocol.mddoc · 24,677 bytesreferences/metrics-catalog.mddoc · 7,157 bytesreferences/skill-patterns.mddoc · 3,580 bytesreferences/state-management.mddoc · 1,727 bytesscripts/__init__.pyruns · 0 bytesscripts/achievements.pyruns · 6,758 bytesscripts/analyze-skill.shruns · 9,305 bytesscripts/auto-improve.pyruns · 32,712 bytesscripts/cli.pyruns · 53,060 bytesscripts/doctor.pyruns · 30,454 bytesscripts/drift.pyruns · 11,342 bytesscripts/episodic-store.pyruns · 151 bytesscripts/episodic_store.pyruns · 19,988 bytesscripts/eval_split.pyruns · 3,241 bytesscripts/evolve/__init__.pyruns · 45 bytesscripts/evolve/budget.pyruns · 2,614 bytesscripts/evolve/content.pyruns · 3,681 bytesscripts/evolve/engine.pyruns · 19,436 bytesscripts/evolve/guard.pyruns · 2,902 bytesscripts/evolve/lineage.pyruns · 5,058 bytesscripts/evolve/llm.pyruns · 5,806 bytesscripts/evolve/plateau.pyruns · 2,830 bytesscripts/evolve/prompts.pyruns · 5,594 bytesscripts/evolve/sanitize.pyruns · 4,896 bytesscripts/generate-report.pyruns · 21,796 bytesscripts/init-skill.pyruns · 34,555 bytesscripts/judge/judge_v0.pyruns · 11,569 bytesscripts/manifest.pyruns · 19,722 bytesscripts/measure_patch_ratio.pyruns · 2,326 bytesscripts/meta-report.pyruns · 145 bytesscripts/meta_report.pyruns · 16,497 bytesscripts/nlp.pyruns · 3,545 bytesscripts/parallel-runner.pyruns · 153 bytesscripts/parallel_runner.pyruns · 17,089 bytesscripts/progress.pyruns · 30,811 bytesscripts/report.pyruns · 7,375 bytesscripts/run-eval.shruns · 22,741 bytesscripts/runtime-evaluator.pyruns · 10,087 bytesscripts/score-skill.pyruns · 8,178 bytesscripts/score_skill.pyruns · 805 bytesscripts/scoring/__init__.pyruns · 1,354 bytesscripts/scoring/clarity.pyruns · 9,283 bytesscripts/scoring/coherence.pyruns · 3,670 bytesscripts/scoring/command_resolution.pyruns · 24,699 bytesscripts/scoring/completeness.pyruns · 9,634 bytesscripts/scoring/composability.pyruns · 5,279 bytesscripts/scoring/composite.pyruns · 11,081 bytesscripts/scoring/credentials.pyruns · 4,416 bytesscripts/scoring/diff.pyruns · 3,707 bytesscripts/scoring/edges.pyruns · 4,739 bytesscripts/scoring/efficiency.pyruns · 9,860 bytesscripts/scoring/formats.pyruns · 8,791 bytesscripts/scoring/guards.pyruns · 10,984 bytesscripts/scoring/operational_coverage.pyruns · 27,058 bytesscripts/scoring/output_contract.pyruns · 10,646 bytesscripts/scoring/patterns/__init__.pyruns · 731 bytesscripts/scoring/patterns/base.pyruns · 26,062 bytesscripts/scoring/patterns/skill_md.pyruns · 11,709 bytesscripts/scoring/patterns/system_prompt.pyruns · 10,819 bytesscripts/scoring/quality.pyruns · 5,770 bytesscripts/scoring/registry.pyruns · 6,537 bytesscripts/scoring/runtime.pyruns · 8,110 bytesscripts/scoring/security.pyruns · 9,507 bytesscripts/scoring/structure.pyruns · 9,474 bytesscripts/scoring/structure_prompt.pyruns · 13,679 bytesscripts/scoring/triggers.pyruns · 6,607 bytesscripts/shared.pyruns · 41,777 bytesscripts/skill-mesh.pyruns · 143 bytesscripts/skill_mesh.pyruns · 34,563 bytesscripts/sync.pyruns · 25,795 bytesscripts/terminal_art.pyruns · 12,470 bytesscripts/test-integration.shruns · 70,076 bytesscripts/test-self.shruns · 10,267 bytesscripts/text-gradient.pyruns · 149 bytesscripts/text_gradient.pyruns · 58,686 bytesscripts/track.pyruns · 9,531 bytesscripts/verify.pyruns · 14,923 bytestemplates/eval-suite-template.jsonasset · 4,624 bytestemplates/improvement-log-template.jsonlasset · 328 bytestemplates/improvement-log-template.tsvasset · 106 bytestests/fixtures/command-signal/deserves.mddoc · 3,028 bytestests/fixtures/command-signal/dump.mddoc · 2,462 bytestests/fixtures/credential-repo/AGENTS.mddoc · 818 bytestests/fixtures/dangling-repo/AGENTS.mddoc · 383 bytestests/fixtures/dangling-repo/Makefileruns · 23 bytestests/fixtures/dangling-repo/package.jsonruns · 79 bytestests/fixtures/v630_baseline.jsonasset · 280 bytestests/proof/bad-eval-suite.jsonasset · 2,220 bytestests/proof/bad-skill.mddoc · 317 bytestests/proof/test-proof.shruns · 6,642 bytestests/unit/conftest.pyruns · 886 bytestests/unit/fixtures/system_prompts/bad_minimal.txtdoc · 124 bytestests/unit/fixtures/system_prompts/good_api_assistant.txtdoc · 4,399 bytestests/unit/fixtures/system_prompts/looks_like_skill.txtdoc · 732 bytestests/unit/fixtures/system_prompts/mediocre_chatbot.txtdoc · 1,150 bytestests/unit/fixtures/system_prompts/xml_tags_prompt.txtdoc · 1,830 bytestests/unit/test_action_security.pyruns · 1,909 bytestests/unit/test_agents_md_profile.pyruns · 12,607 bytestests/unit/test_auto_improve_split.pyruns · 4,246 bytestests/unit/test_cadence_rule_stated_once.pyruns · 4,901 bytestests/unit/test_callers_pass_format.pyruns · 6,487 bytestests/unit/test_cli.pyruns · 9,770 bytestests/unit/test_cli_diff.pyruns · 12,565 bytestests/unit/test_cli_error_handling.pyruns · 4,806 bytestests/unit/test_cli_new.pyruns · 16,917 bytestests/unit/test_collect_traffic.pyruns · 14,822 bytestests/unit/test_command_docs_document_the_loop.pyruns · 5,691 bytestests/unit/test_command_docs_flags_exist.pyruns · 4,250 bytestests/unit/test_command_resolution.pyruns · 26,798 bytestests/unit/test_compare.pyruns · 8,851 bytestests/unit/test_composability_structural_signals.pyruns · 8,829 bytestests/unit/test_composite_unified.pyruns · 21,692 bytestests/unit/test_composite_weights.pyruns · 23,038 bytestests/unit/test_credential_gate.pyruns · 9,508 bytestests/unit/test_credential_review_fixes.pyruns · 19,100 bytestests/unit/test_credentials.pyruns · 6,218 bytestests/unit/test_diff_scoring.pyruns · 17,256 bytestests/unit/test_doctor.pyruns · 3,437 bytestests/unit/test_doctor_collapses_duplicate_copies.pyruns · 40,870 bytestests/unit/test_doctor_multiformat.pyruns · 5,174 bytestests/unit/test_doctor_positional_dirs.pyruns · 3,991 bytestests/unit/test_documented_command_forms.pyruns · 4,823 bytestests/unit/test_documented_command_signal.pyruns · 7,517 bytestests/unit/test_drift.pyruns · 10,976 bytestests/unit/test_edge_cases.pyruns · 16,096 bytestests/unit/test_efficiency_length_is_charged.pyruns · 3,030 bytestests/unit/test_episodic_store.pyruns · 2,857 bytestests/unit/test_eval_split.pyruns · 2,775 bytestests/unit/test_eval_suite_is_portable_ere.pyruns · 3,389 bytestests/unit/test_eval_suite_owner.pyruns · 8,837 bytestests/unit/test_evolve_budget.pyruns · 2,756 bytestests/unit/test_evolve_content.pyruns · 5,884 bytestests/unit/test_evolve_engine.pyruns · 8,991 bytestests/unit/test_evolve_guard.pyruns · 4,563 bytestests/unit/test_evolve_lazy_import.pyruns · 2,160 bytestests/unit/test_evolve_lineage.pyruns · 5,474 bytestests/unit/test_evolve_llm.pyruns · 5,466 bytestests/unit/test_evolve_plateau.pyruns · 3,418 bytestests/unit/test_evolve_prompt_injection.pyruns · 11,259 bytestests/unit/test_evolve_prompts.pyruns · 2,080 bytestests/unit/test_evolve_sanitize.pyruns · 7,350 bytestests/unit/test_formats.pyruns · 6,375 bytestests/unit/test_gate1_verdict.pyruns · 4,740 bytestests/unit/test_gate_power_wiring.pyruns · 5,909 bytestests/unit/test_golden.pyruns · 12,771 bytestests/unit/test_gradient_delta_scale.pyruns · 6,469 bytestests/unit/test_gradient_target.pyruns · 2,379 bytestests/unit/test_guards.pyruns · 7,041 bytestests/unit/test_init_skill.pyruns · 11,707 bytestests/unit/test_install_version.pyruns · 8,250 bytestests/unit/test_judge_v0.pyruns · 4,793 bytestests/unit/test_known_gaming_limits.pyruns · 2,640 bytestests/unit/test_leaderboard_kv.pyruns · 15,114 bytestests/unit/test_leaderboard_storage.pyruns · 6,012 bytestests/unit/test_leaderboard_versioning.pyruns · 3,143 bytestests/unit/test_manifest.pyruns · 28,614 bytestests/unit/test_measurement_scripts.pyruns · 7,576 bytestests/unit/test_normalization.pyruns · 4,354 bytestests/unit/test_opcov_gradients.pyruns · 10,459 bytestests/unit/test_operational_coverage.pyruns · 29,280 bytestests/unit/test_parallel_runner.pyruns · 1,856 bytestests/unit/test_patch_ratio.pyruns · 1,266 bytestests/unit/test_patterns.pyruns · 24,619 bytestests/unit/test_patterns_are_bounded.pyruns · 5,614 bytestests/unit/test_patterns_scale_linearly.pyruns · 29,891 bytestests/unit/test_patterns_split.pyruns · 6,423 bytestests/unit/test_playground_score.pyruns · 8,358 bytestests/unit/test_registry.pyruns · 11,030 bytestests/unit/test_regression_v71.pyruns · 7,307 bytestests/unit/test_report.pyruns · 5,848 bytestests/unit/test_run_eval_timeout_visibility.pyruns · 6,193 bytestests/unit/test_runtime_evaluator_security.pyruns · 5,171 bytestests/unit/test_sanitize_coverage.pyruns · 1,664 bytestests/unit/test_scoring.pyruns · 52,994 bytestests/unit/test_scoring_edges_malformed.pyruns · 10,276 bytestests/unit/test_scoring_redos.pyruns · 10,474 bytestests/unit/test_scoring_runtime_enabled.pyruns · 12,754 bytestests/unit/test_scoring_type_guards.pyruns · 7,462 bytestests/unit/test_security.pyruns · 13,727 bytestests/unit/test_security_field_false_positives.pyruns · 15,193 bytestests/unit/test_shared.pyruns · 12,841 bytestests/unit/test_skill_card_executable.pyruns · 6,203 bytestests/unit/test_skill_discovery_excludes_vendored.pyruns · 11,087 bytestests/unit/test_skill_mesh.pyruns · 7,226 bytestests/unit/test_stress.pyruns · 34,462 bytestests/unit/test_suggest.pyruns · 7,510 bytestests/unit/test_sync.pyruns · 20,556 bytestests/unit/test_system_prompt_scoring.pyruns · 39,913 bytestests/unit/test_terminal_art.pyruns · 10,783 bytestests/unit/test_tokens.pyruns · 7,579 bytestests/unit/test_track.pyruns · 9,871 bytestests/unit/test_trigger_precision_recall.pyruns · 5,118 bytestests/unit/test_url.pyruns · 853 bytestests/unit/test_verify.pyruns · 23,161 bytestests/unit/test_version_consistency.pyruns · 2,929 bytestests/unit/test_version_pin_limit_stated_once.pyruns · 6,430 bytes
Read excerpt
# schliff — deterministic instruction-file linter
## Overview
Scores one instruction file per dimension and turns that score into a CI gate.
## Prerequisites
`uv` on PATH (it provides `uvx`). No API key. Expects an instruction-file path
for most commands; see each command's `--help`.
## Commands
These run anywhere `uv` is available: no plugin, no checkout. All except `badge`