skillcheck

Category: Tools & Productivity | Uploader: moonrunnerkc | Downloads: 0 | Version: v1.0（Latest）

Validates SKILL.md files for spec-facing structure, sizing, references, cross-agent compatibility, and agent-authored critique or graph diagnostics.

Changelog: Source: GitHub https://github.com/moonrunnerkc/skillcheck

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 1.5 KB
- 📄 banner.svg 1.3 KB
- 📄 skillcheck-v1-upgrade-plan.md 11.6 KB
📁 action/
- 📄 entrypoint.py 8.5 KB
📁 docs/
- 📄 case-study-silent-skill-failure.md 6.6 KB
- 📄 case-study-v1-real-world-runs.md 8.8 KB
📁 scripts/
- 📄 regen_self_host_fixtures.py 1.6 KB
- 📄 summarize_batch.py 12.4 KB
📁 skills/
- 📁 skillcheck/
  - 📄 SKILL.md 3.7 KB
📁 src/
- 📁 skillcheck/
  - 📁 agents/
    
    📄 __init__.py 3.0 KB
    
    📄 base.py 6.9 KB
    
    📄 claude.py 905 B
    
    📄 codex.py 2.4 KB
    
    📄 cursor.py 2.5 KB
    
    📄 graph_base.py 8.8 KB
    
    📄 graph_claude.py 932 B
    
    📄 graph_codex.py 2.4 KB
    
    📄 graph_cursor.py 2.2 KB
    
    📄 graph_parser.py 13.8 KB
    
    📄 parser.py 10.0 KB
    
    📄 schema.py 3.5 KB
  - 📁 core/
    
    📄 __init__.py 2.1 KB
    
    📄 activation.py 5.4 KB
    
    📄 activation_render.py 2.4 KB
    
    📄 graph.py 18.6 KB
    
    📄 graph_analyzers.py 13.2 KB
    
    📄 graph_render.py 3.3 KB
    
    📄 history.py 16.8 KB
    
    📄 reporter.py 3.0 KB
    
    📄 semantic.py 7.2 KB
    
    📄 symbolic.py 2.4 KB
  - 📁 rules/
    
    📄 __init__.py 5.2 KB
    
    📄 compat.py 7.0 KB
    
    📄 description.py 12.1 KB
    
    📄 disclosure.py 5.3 KB
    
    📄 frontmatter.py 1.3 KB
    
    📄 frontmatter_common.py 2.1 KB
    
    📄 frontmatter_description.py 4.9 KB
    
    📄 frontmatter_fields.py 2.9 KB
    
    📄 frontmatter_name.py 6.0 KB
    
    📄 references.py 4.4 KB
    
    📄 sizing.py 1.9 KB
    
    📄 template.py 845 B
  - 📄 __init__.py 328 B
  - 📄 __main__.py 140 B
  - 📄 cli.py 41.3 KB
  - 📄 config.py 3.1 KB
  - 📄 config_loader.py 7.8 KB
  - 📄 parser.py 1.6 KB
  - 📄 py.typed 0 B
  - 📄 result.py 1.7 KB
  - 📄 template_detection.py 1.4 KB
  - 📄 tokenizer.py 2.4 KB
📁 tests/
- 📁 fixtures/
  - 📁 critique/
    
    📄 malformed_prose_preamble.txt 230 B
    
    📄 minimal_valid.md 179 B
    
    📄 multi_section.md 822 B
    
    📄 response_clean.json 150 B
    
    📄 response_contradiction.json 375 B
    
    📄 response_findings_mixed.json 990 B
    
    📄 response_malformed.json 146 B
    
    📄 response_schema_error.json 197 B
    
    📄 response_warnings.json 210 B
    
    📄 with_code_blocks.md 505 B
  - 📁 graph/
    
    📄 skill_basic_io.md 481 B
    
    📄 skill_duplicate_section.md 262 B
    
    📄 skill_empty_capability.md 253 B
    
    📄 skill_frontmatter_tools.md 218 B
    
    📄 skill_imperative_capabilities.md 436 B
    
    📄 skill_no_structure.md 362 B
    
    📄 skill_orphan_capability.md 313 B
    
    📄 skill_section_aliases.md 294 B
    
    📄 skill_unproduced_output.md 286 B
    
    📄 skill_unreferenced_tool.md 331 B
    
    📄 skill_unused_input.md 384 B
  - 📁 graph_responses/
    
    📄 response_bad_line.json 255 B
    
    📄 response_clean.json 1.1 KB
    
    📄 response_extra_capabilities.json 1.5 KB
    
    📄 response_malformed.json 150 B
    
    📄 response_schema_error.json 108 B
    
    📄 response_with_contradiction.json 1.2 KB
  - 📁 history/
    
    📄 ledger_malformed.json 73 B
    
    📄 ledger_multi_run_passing.json 1.5 KB
    
    📄 ledger_one_run.json 539 B
    
    📄 ledger_with_regression.json 1016 B
  - 📁 self_host/
    
    📄 critique_clean.json 150 B
    
    📄 graph_clean.json 3.4 KB
  - 📁 templates/
    
    📄 SKILL.md 128 B
  - 📁 user_extension/
    
    📄 skillcheck.toml 63 B
    
    📄 user_extension_field.md 140 B
  - 📄 bad_body_long.md 4.4 KB
  - 📄 bad_desc_empty.md 72 B
  - 📄 bad_desc_person.md 149 B
  - 📄 bad_desc_quality.md 109 B
  - 📄 bad_field_typo.md 204 B
  - 📄 bad_name_caps.md 157 B
  - 📄 bad_name_consecutive_hyphens.md 151 B
  - 📄 bad_name_leading_hyphen.md 146 B
  - 📄 bad_name_long.md 208 B
  - 📄 bad_name_reserved.md 126 B
  - 📄 bad_name_trailing_hyphen.md 146 B
  - 📄 bad_no_frontmatter.md 151 B
  - 📄 bad_refs.md 297 B
  - 📄 canvas_design_pattern.md 238 B
  - 📄 claude_api_name.md 98 B
  - 📄 claude_only_fields.md 248 B
  - 📄 cursor_desc_folded_keep.md 356 B
  - 📄 cursor_desc_folded_strip.md 383 B
  - 📄 cursor_desc_literal.md 357 B
  - 📄 frontmatter_heading_partial.md 318 B
  - 📄 frontmatter_name_as_heading.md 297 B
  - 📄 homepage_field.md 141 B
  - 📄 license_field.md 122 B
  - 📄 non_template_with_placeholder_word.md 93 B
  - 📄 repository_field.md 159 B
  - 📄 template_explicit_flag.md 158 B
  - 📄 template_placeholder_description.md 143 B
  - 📄 template_with_real_violations.md 217 B
  - 📄 unknown_field.md 118 B
  - 📄 valid_basic.md 168 B
  - 📄 valid_full.md 443 B
  - 📄 valid_good_desc.md 385 B
- 📄 conftest.py 161 B
- 📄 test_agent_prompts.py 6.4 KB
- 📄 test_batch15_summarize.py 3.0 KB
- 📄 test_cli.py 9.7 KB
- 📄 test_cli_critique.py 10.8 KB
- 📄 test_cli_critique_agent.py 4.7 KB
- 📄 test_cli_graph.py 7.6 KB
- 📄 test_cli_graph_agent.py 9.8 KB
- 📄 test_cli_history.py 14.4 KB
- 📄 test_compat.py 10.4 KB
- 📄 test_critique_parser.py 9.3 KB
- 📄 test_critique_prompt.py 4.3 KB
- 📄 test_critique_schema.py 6.7 KB
- 📄 test_description.py 9.1 KB
- 📄 test_disclosure.py 6.4 KB
- 📄 test_frontmatter.py 13.5 KB
- 📄 test_graph_analyzers.py 7.0 KB
- 📄 test_graph_divergence.py 5.9 KB
- 📄 test_graph_heuristic.py 18.3 KB
- 📄 test_graph_parser.py 9.1 KB
- 📄 test_graph_prompts.py 5.7 KB
- 📄 test_graph_render.py 6.4 KB
- 📄 test_history_io.py 7.8 KB
- 📄 test_history_model.py 8.2 KB
- 📄 test_history_regression.py 5.2 KB
- 📄 test_name_compliance.py 4.3 KB
- 📄 test_parser.py 2.3 KB
- 📄 test_readme_test_count_claim.py 1.8 KB
- 📄 test_references.py 8.1 KB
- 📄 test_self_host.py 6.2 KB
- 📄 test_semantic_bridge.py 15.9 KB
- 📄 test_sizing.py 3.5 KB
- 📄 test_tokenizer.py 1013 B
- 📄 test_type_annotations.py 766 B
- 📄 test_v1_2_false_positive_fixes.py 6.6 KB
- 📄 test_v1_architecture.py 5.2 KB
- 📄 test_v1_completion.py 2.9 KB
- 📄 test_version_coherence.py 2.7 KB
- 📄 test_yaml_anchors.py 2.4 KB
- 📄 test_yaml_types.py 4.2 KB
📄 .gitignore 420 B
📄 action.yml 4.8 KB
📄 CHANGELOG.md 20.3 KB
📄 LICENSE 1.1 KB
📄 Makefile 802 B
📄 pyproject.toml 680 B
📄 README.md 23.9 KB
📄 RELEASE_NOTES_v1.0.0.md 7.7 KB
📄 RELEASE_NOTES_v1.0.1.md 4.0 KB
📄 RELEASE_NOTES_v1.1.0.md 3.4 KB
📄 SKILL.md 1.2 KB

SKILL.md

---
name: skillcheck
description: Validates SKILL.md files for spec-facing structure, sizing, references, cross-agent compatibility, and agent-authored critique or graph diagnostics.
version: "1.2.0"
author: brad
---

Use this skill when validating a `SKILL.md` file or a directory of skill files with the `skillcheck` CLI.

## Validate

Run the default symbolic checks:

```bash
skillcheck SKILL.md
skillcheck skills/ --format json
```

The report includes errors, warnings, and info diagnostics. Exit code 0 means no errors. Exit code 1 means at least one error, or warnings with `--warnings-as-errors`. Exit code 2 means input or argument error. Exit code 3 means symbolic validation passed but ingested agent critique found semantic errors.

## Agent workflows

For semantic self-critique, emit a prompt and ingest the returned JSON:

```bash
skillcheck SKILL.md --emit-critique-prompt > prompt.txt
skillcheck SKILL.md --ingest-critique response.json
```

For capability graph work, use:

```bash
skillcheck SKILL.md --analyze-graph
skillcheck SKILL.md --emit-graph --format json
```

## Configuration

`skillcheck.toml` can set CLI defaults and frontmatter extension fields:

```toml
[frontmatter]
extension_fields = ["my-org-tag", "internal-id"]
```

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

skillcheck

Directory Structure

SKILL.md

Report

Notice