skillc 0.2.1

A development kit for Agent Skills - the open format for extending AI agent capabilities
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

# Contributing to skillc

Thank you for your interest in contributing to skillc! This document provides guidelines and instructions for contributing.

## Getting Started

### Prerequisites

- Rust 1.85 or later (we use Edition 2024)
- Just (command runner)
- pre-commit (for git hooks)

### Development Setup

1. **Clone the repository**

```bash
git clone https://github.com/govctl-org/skillc
cd skillc
```

2. **Install development tools**

```bash
# Install Just
cargo install just

# Install pre-commit hooks
pre-commit install
```

3. **Build the project**

```bash
just build
```

## Development Commands

| Command                 | Description                   |
| ----------------------- | ----------------------------- |
| `just build`            | Build release binary          |
| `just test`             | Run all tests                 |
| `just lint`             | Run clippy lints              |
| `just fmt`              | Format code                   |
| `just pre-commit`       | Run all pre-commit hooks      |
| `just update-snapshots` | Update test snapshots         |
| `just deny`             | Run cargo-deny security audit |
| `just check`            | Validate governed documents   |
| `just render`           | Render RFCs to markdown       |

## Code Style

- **Formatting**: Code is formatted with `cargo fmt`
- **Linting**: Clippy runs with `cargo clippy --workspace -- -D warnings` (warnings are errors)
- **Testing**: All tests must pass before merging

## Commit Messages

We follow the [Conventional Commits](https://www.conventionalcommits.org/) specification:

| Prefix            | Description                  |
| ----------------- | ---------------------------- |
| `feat(scope)`     | New feature                  |
| `fix(scope)`      | Bug fix                      |
| `docs(scope)`     | Documentation changes        |
| `test(scope)`     | Test additions/modifications |
| `refactor(scope)` | Code restructuring           |
| `chore(scope)`    | Maintenance tasks            |

Examples:

```
feat(compiler): add progressive disclosure support
fix(resolver): handle symlinks in skill paths
docs(readme): update installation instructions
```

## Governance

This project uses a governed workflow based on RFCs and work items:

1. **Work Items**: All changes are tracked in `gov/work/`
2. **RFCs**: New features require RFCs in `gov/rfc/`
3. **ADRs**: Architectural decisions are recorded in `gov/adr/`

Use `govctl` commands to manage governance:

```bash
govctl work list pending  # List work items
govctl rfc list           # List RFCs
govctl check              # Validate all governed documents
```

## Pull Requests

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run `just pre-commit` to verify all checks pass
5. Submit a pull request

## Security

- Do not commit secrets or credentials
- Use `cargo deny` to check for vulnerable dependencies
- Report security issues via GitHub Security Advisories

## Questions?

- Check the [README](README.md) for project overview
- Review RFCs in `docs/rfc/` for protocol specifications
- Open an issue for questions or suggestions