bitflight-devops/skilllint
Validate Claude Code plugins, skills, agents, and commands using skilllint
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jun 13, 2026
- License
- MIT
Pinned Snippet
uses: bitflight-devops/skilllint@29643fae9ed3a3ebf370f37c607a215deaa29b4e # v1.8.1tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| paths | Space-separated list of paths to validate (files or directories). Defaults to the current working directory. | no | . |
| platform | Platform adapter to use for validation. Supported values: claude-code, cursor, codex. Leave empty to validate against all platforms. | no | "" |
| fix | Auto-fix issues where possible. Mutually exclusive with check-only. | no | false |
| check-only | Validate only, do not auto-fix. Mutually exclusive with fix. | no | false |
| verbose | Show detailed validation output including info messages. | no | false |
| no-color | Disable color output. Recommended for CI logs. | no | true |
| tokens-only | Output only the integer token count (for programmatic use). | no | false |
| show-progress | Show per-file PASSED/FAILED status for all scanned files. | no | false |
| show-summary | Show a validation summary panel at the end of the run. | no | true |
| filter | Glob pattern to restrict which files inside a directory are validated. | no | "" |
| filter-type | Restrict validation to a specific file type. Supported values: skills, agents, commands. | no | "" |
| version | Version of skilllint to install (e.g. "1.2.3", "latest"). Use "latest" to always install the newest published release. | no | latest |
| python-version | Python version to use when running skilllint. | no | 3.12 |
Outputs
| name | description |
|---|---|
| result | Validation outcome: 'passed' when exit code is 0 (all checks pass), 'failed' for any non-zero exit code (validation errors or usage/configuration errors). Use the 'exit-code' output to distinguish between exit code 1 (validation errors) and exit code 2 (usage/configuration errors). |
| exit-code | Raw exit code returned by skilllint check. 0 = all checks passed, 1 = validation errors found, 2 = usage/configuration error. |