Skip to content

Commit 3b25286

Browse files
committed
chore: GEO optimization — topics, badges, community files, ARTICLE author
1 parent ef62749 commit 3b25286

5 files changed

Lines changed: 86 additions & 1 deletion

File tree

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
name: Bug report
3+
about: Parsing or generation issue
4+
title: "[Bug] "
5+
labels: bug
6+
---
7+
8+
**CLI tool and version**
9+
e.g. `gh version 2.45.0`
10+
11+
**Command run**
12+
```
13+
cli2skill generate ...
14+
```
15+
16+
**--help output of the tool** (paste or attach)
17+
```
18+
(paste here)
19+
```
20+
21+
**Expected vs actual result**
22+
23+
**Environment**
24+
- OS:
25+
- Python version:
26+
- cli2skill version:
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
name: Feature request
3+
about: Suggest an improvement
4+
title: "[Feature] "
5+
labels: enhancement
6+
---
7+
8+
**What CLI framework or tool?**
9+
10+
**What would you like cli2skill to do?**
11+
12+
**Example --help output** (if relevant)
13+
```
14+
(paste here)
15+
```

ARTICLE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,6 @@ A: `cli2skill` 支持 `--wrap-mcp` 模式——生成一个 thin CLI wrapper 来
203203

204204
---
205205

206-
*作者:[TODO]*
206+
*作者:[2233admin](https://github.com/2233admin)*
207207
*日期:2026-03-24*
208208
*License: MIT*

CONTRIBUTING.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Contributing to cli2skill
2+
3+
## Quick Wins
4+
5+
- **Test with your CLI tools** — run `cli2skill generate <your-tool>` and report how it handles your help format
6+
- **Report unsupported help formats** — if parsing fails for a specific CLI framework, file an issue with the `--help` output
7+
- **Add examples** — generated skills for popular CLIs (aws, docker, kubectl, terraform...)
8+
9+
## Development
10+
11+
```bash
12+
git clone https://github.com/2233admin/cli2skill.git
13+
cd cli2skill
14+
pip install -e .
15+
cli2skill preview gh
16+
```
17+
18+
Python 3.10+. Zero external dependencies.
19+
20+
## Architecture
21+
22+
```
23+
cli2skill/
24+
├── main.py ← CLI entry point (Typer-style)
25+
├── parser.py ← --help output parser (regex-based, multi-framework)
26+
├── generator.py ← SKILL.md markdown generator
27+
└── mcp2skill.py ← MCP server → CLI skill converter
28+
```
29+
30+
## Adding Support for a New CLI Framework
31+
32+
1. Add a detection pattern in `parser.py`
33+
2. Add a test case in `examples/`
34+
3. Document the framework in the Supported Formats table
35+
36+
## Ideas
37+
38+
- [ ] Auto-detect framework from help output format
39+
- [ ] `cli2skill batch` — convert all CLIs in PATH
40+
- [ ] `cli2skill mcp-audit` — scan settings.json, show which MCPs can be replaced
41+
- [ ] Web UI for previewing generated skills
42+
- [ ] Integration with `skills-cli` install flow

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,9 +15,11 @@
1515
</p>
1616

1717
<p align="center">
18+
<a href="https://pypi.org/project/cli2skill/"><img src="https://img.shields.io/pypi/v/cli2skill?color=blue" alt="PyPI"/></a>
1819
<img src="https://img.shields.io/badge/dependencies-zero-brightgreen" alt="zero dependencies"/>
1920
<img src="https://img.shields.io/badge/platforms-26+-blue" alt="26+ platforms"/>
2021
<img src="https://img.shields.io/badge/python-3.10+-yellow" alt="python 3.10+"/>
22+
<a href="https://github.com/2233admin/cli2skill/stargazers"><img src="https://img.shields.io/github/stars/2233admin/cli2skill?style=social" alt="stars"/></a>
2123
<img src="https://img.shields.io/github/license/2233admin/cli2skill" alt="license"/>
2224
</p>
2325

0 commit comments

Comments
 (0)