Metadata-Version: 2.5
Name: skillpack-lint
Version: 0.1.0
Summary: Lint, test and package agent skills (SKILL.md-based capability packs)
Project-URL: Homepage, https://github.com/dycshow/skilllint
Project-URL: Repository, https://github.com/dycshow/skilllint
Project-URL: Issues, https://github.com/dycshow/skilllint/issues
Author-email: dycshow <dycshow@users.noreply.github.com>
License: MIT
License-File: LICENSE
Keywords: agents,lint,llm,mcp,skills
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: pyyaml>=6.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == 'test'
Description-Content-Type: text/markdown

﻿# SkillLint

> Agent 技能包（SKILL.md）的 **lint / test / package** 开发工具。

Agent Skills 正在变成"标准化的软件组件"——但至今没有工具检查技能包的质量。SkillLint 填补这个空白：校验结构、发现隐患、打包分发。

## 安装

```bash
pip install agent-skilllint
```

## 使用

```bash
skilllint check ./my-skill        # 校验技能包：结构 / frontmatter / 安全
skilllint test  ./my-skill        # 冒烟测试：SKILL.md 可读、脚本资产存在
skilllint package ./my-skill -o dist   # 打包成可分发 zip（含 manifest.json）
```

## 校验项（check）

| 级别 | 规则 | 说明 |
| --- | --- | --- |
| fail | structure | SKILL.md 必须存在且非空 |
| fail | frontmatter | YAML frontmatter 必须合法，含 name + description |
| fail | security | 禁止提交 .env / 私钥 / 凭据类文件 |
| warn | name-format | 目录名应符合 `^[a-z0-9][a-z0-9._-]*$` |
| warn | frontmatter | name 与目录名不一致、description 过短 |
| warn | docs | 缺少 README.md |

## 为什么做这个

- **趋势**：Agent Skills 技能化是 2026 年最热方向之一，技能包需要"版本管理、单元测试、社区共享"
- **空白**：大家都在造技能包，没人做技能包的质量工具
- **自用**：你可以直接 `skilllint check` 自己环境里安装的任意技能目录

## 路线图

- [x] check / test / package
- [x] frontmatter 校验 + 安全文件检测
- [ ] 多约定支持（.agents / anthropic skills）
- [ ] 引用资产解析（SKILL.md 中相对路径存在性）
- [ ] GitHub Action 发布工作流

## 演示

真实运行回放（含截图说明）：[docs/demo.md](docs/demo.md)——合法包通过 / 问题包检出 fail / 打包分发全流程。

## 许可

MIT
