speclite-agent-lint

speclite-agent-lint is a skill for Claude Code from flanliulf/SpecLite. It costs 109 tokens per session (1,236 once invoked), scanned A, original, MIT.

A read-only checker for SpecLite agent definition packages, including their role instructions, settings, menus, and referenced files.

In plain words
What is it for?
Use it to inspect one agent or a group of agents and receive a structured report with fixes grouped by severity.
Why use it?
It finds broken links, missing configuration, lost role behavior, outdated runtime references, and other definition problems before use.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Good fit Use it to inspect one agent or a group of agents and receive a structured report with fixes grouped by severity.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/flanliulf/speclite/speclite-agent-lint
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add flanliulf/SpecLite --skill speclite-agent-lint
Clone the repo
git clone --depth 1 https://github.com/flanliulf/SpecLite

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for speclite-agent-lint

README.md
[![agentmods](https://agentmods.dev/badge/skills/flanliulf/speclite/speclite-agent-lint/github.svg)](https://agentmods.dev/skills/flanliulf/speclite/speclite-agent-lint)
Your own site
<a href="https://agentmods.dev/skills/flanliulf/speclite/speclite-agent-lint"><img src="https://agentmods.dev/badge/skills/flanliulf/speclite/speclite-agent-lint/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for speclite-agent-lint

Your own site · 80×15
<a href="https://agentmods.dev/skills/flanliulf/speclite/speclite-agent-lint"><img src="https://agentmods.dev/badge/skills/flanliulf/speclite/speclite-agent-lint.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 109 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,236 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00109 $0.01236
Opus 5 $0.00055 $0.00618
Sonnet 5 $0.00022 $0.00247
Haiku 4.5 $0.00011 $0.00124

Measured 8d ago against content hash e59c186580b2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

speclite-agent-lint scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/check_agent_skill.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

assets/source/speclite/support-skills/speclite-agent-lint/SKILL.md · 47 lines

What it actually says

[Overview(技能说明)] Speclite Agent Lint 是只读规范检查器,用于审查 speclite-agent-* 定义包。它在通用 Skill 规则基础上增加 Agent 专属语义检查,重点防止 [agent] 被误检为 [workflow]、菜单目标断链、persona 激活语义丢失和 BMad runtime 残留。

[Core Capabilities(核心能力)] - 通用 Skill 合规检查:验证 YAML frontmatter、description、allowed-tools、metadata、版本一致性、正文长度、必需章节和引用路径。 - Agent 定制块检查:确认 customize.toml 存在 [agent],关键字段完整,数组与数组表结构符合合并规则。 - 激活流程检查:确认入口使用 Speclite resolver 的 --key agent,并保留 persona、persistent facts、config、greet、menu dispatch 和持续身份规则。 - 菜单完整性检查:验证 [[agent.menu]] 的 code 唯一、description 非空、每项只能包含 skillprompt 之一,并检查目标 Skill 或本地 prompt 文件存在。 - Speclite 运行模型检查:扫描 _bmadconfig.yaml/bmad:*、源码仓库 runtime 依赖和 config fallback 误用。 - Deterministic 脚本检查:运行 scripts/check_agent_skill.py,用可复核 JSON 结果支撑人工报告。 - 文件归类检查:检查根目录 Markdown 白名单、prompt 文件迁移、references/assets/ 职责边界。 - 修复方案输出:按 Critical / Major / Minor / Observation 输出证据、影响、建议调整和验证方式。

[Workflow(执行流程)] 1. 确认目标 Agent Skill 目录、Skill 名称或 --all 扫描根;若未提供路径或名称,先询问,不猜测。 2. 完整阅读 references/lint-rules.md,按规则读取目录、SKILL.mdCHANGELOG.mdcustomize.toml、引用的 references/assets 和本地 prompt。 3. 对目标目录运行只读脚本:python3 scripts/check_agent_skill.py <agent-dir>;批量扫描时运行 python3 scripts/check_agent_skill.py --all assets/source/speclite/sdlc-skills。 4. 执行通用规则:frontmatter、description、版本、正文章节、根目录文件、引用路径和命名。 5. 执行 Agent 专属规则:[agent] 字段、激活流程、--key agent、persona 语义、菜单项、prompt 文件、持续身份。 6. 执行 Speclite 专属规则:runtime 路径、_speclite/config.toml、custom fallback、BMad 残留、公共源码目录混用。 7. 输出报告:使用 assets/report-template.md 格式,列出结论、Findings、调整方案和验证建议。 8. 如果用户要求重新检查,重新执行完整扫描并标注已修复、新增和仍存在问题。

[Notes(注意事项)] - 本 Skill 属于 support-skills/,只服务 SpecLite canonical skill 源定义检查,不属于目标项目默认 SDLC runtime 安装集合。 - 默认只读,绝不修改目标 Agent Skill 文件。 - scripts/check_agent_skill.py 是确定性证据来源;人工报告不得与脚本中的 Critical/Major 结论矛盾。 - customize.toml 对 Agent 必须承载 [agent],不能套用 workflow-only lint 规则。 - Agent 包的 SKILL.en.md 不是硬性必需项;如存在,必须与中文 canonical 入口保持版本和运行模型一致。 - CHANGELOG.md 可以保留 BMAD 来源说明;SKILL.md 和当前 references 不得把 BMAD 路径写成运行依赖。 - 菜单目标不存在时通常是 Major;如果入口会直接分发到不存在的必需目标,可升级为 Critical。 - prompt 引用的文件是执行指令,缺失或路径未迁移会导致 Agent 菜单项不可用。 - 报告必须用中文,路径使用工作区相对路径。

[Generation Metadata(生成信息)] 本 Skill 由 speclite-agent-creator 维护并纳入 SpecLite support-skills 体系。如需修改,必须同步更新 SKILL.mdSKILL.en.mdCHANGELOG.mdreferences/assets/scripts/

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 47 lines · 109 tokens per session scan A e59c186580b2

Subscribe to this mod's changes

speclite-agent-lint is a skill published in the GitHub repository flanliulf/SpecLite (4 stars, last pushed 2mo ago), licensed MIT. It adds 109 tokens to every session and 1,236 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

lain

Structural code intelligence for AI coding agents. Use this skill when the user wants to understand how a codebase is organized (modules, call graphs, file dependencies), find where to start reading, trace the impact of a change, find code by meaning, or understand what a symbol does in its full context. Do NOT use…

spuentesp/lain · 90 tokens

botpipe-workflow-authoring

Author, review, and improve Botpipe workflows. Use when Codex is asked to create packaged or workspace-local Botpipe workflows, convert codebases into workflows, design provider-heavy producer/verifier steps, write Botpipe prompts/contracts, inspect Botpipe traces, or apply Codex CLI/gpt-5.5 workflow patterns.

mrauter1/botpipe · 72 tokens

intake

The planning front-door. Captures feature ideas and bugs as graded rows in the root INTAKE.md ledger. Use it when the user says "log an idea", "capture a bug", "add to the backlog", "note this down", "track this feature", or invokes /intake. Owns the requirements interview — fleshes out thin ideas, proactively…

ndisisnd/msg · 239 tokens

pre-merge

The CI gate. Takes a feature branch from "eng says done" to "PR open against staging with green checks". Runs the project's preflight-resolved pipeline from devkit/policy.json components[]: sync → parallel correctness + security waves → coverage → regression tail → security/migration → PRD-consistency → open PR. Emits…

ndisisnd/msg · 101 tokens

merge

The ship gate — the only skill that merges. --staging merges the feature→staging PR on green CI, deploys, verifies, emits a human test script and stamps the staging sign-off on approval. --production ships the double-confirmed release to main and deploys production. Never self-certifies staging; nothing reaches main…

ndisisnd/msg · 94 tokens

msg

Root menu for msg skills, plus harness modes. --init is the one-time project bootstrap — use it when the user says "initialise project", "bootstrap repo", "set up the framework", "start a new project", or asks to set up project structure in an empty repo. Other modes: --init-staging (add a staging branch), --update…

ndisisnd/msg · 162 tokens