Skip to content

Commit a269350

Browse files
authored
chore(open-source): add launch polish for v0.1.0
1 parent 79f14eb commit a269350

4 files changed

Lines changed: 70 additions & 0 deletions

File tree

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Ask a Question
4+
url: https://github.com/GeneralJerel/chalk-skills/discussions
5+
about: Use Discussions for usage questions and design discussions.
6+
- name: Security Report
7+
url: https://github.com/GeneralJerel/chalk-skills/security/policy
8+
about: Report vulnerabilities through the Security policy process.

Makefile

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
.PHONY: validate init-skill
2+
3+
validate:
4+
bash scripts/validate-skills.sh
5+
6+
init-skill:
7+
@echo "Usage: make init-skill NAME=<skill-name> DESC=\"<description>\" OWNER=<chalk|project>"
8+
@test -n "$(NAME)" || (echo "NAME is required" && exit 1)
9+
@test -n "$(DESC)" || (echo "DESC is required" && exit 1)
10+
@OWNER_VAL=$${OWNER:-project}; \
11+
bash scripts/init-skill.sh "$(NAME)" --description "$(DESC)" --owner "$$OWNER_VAL"

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,15 @@ Skills produce and maintain the `.chalk/` documentation structure:
161161
- Versioning policy: `docs/versioning.md`
162162
- Review checklist: `docs/review-checklist.md`
163163

164+
## Quickstart (Contributors)
165+
166+
```bash
167+
# validate all skills
168+
make validate
169+
170+
# scaffold a new skill
171+
make init-skill NAME=my-skill DESC="what it does and when to use it" OWNER=project
172+
```
164173
## Adding a New Skill
165174

166175
1. Create a folder: `skills/<skill-name>/`

RELEASE_NOTES_v0.1.0.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# v0.1.0 Release Notes (Draft)
2+
3+
## Summary
4+
5+
Initial open-source foundation release for `chalk-skills`.
6+
7+
This release establishes a provider-agnostic skill contract, validation tooling, contribution workflow, and governance baseline for community contributions.
8+
9+
## Highlights
10+
11+
- Standardized skill metadata contract:
12+
- `name`, `description`, `owner`, `version`, `metadata-version`
13+
- Added ownership model and SemVer policy
14+
- Added validator (`scripts/validate-skills.sh`) for contract enforcement
15+
- Added skill scaffolder (`scripts/init-skill.sh`) for consistent skill creation
16+
- Added CI workflow to validate skill metadata on PRs/pushes
17+
- Added contribution and governance docs:
18+
- `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md`, `SUPPORT.md`
19+
- `docs/open-source-scope.md`, `docs/skill-contract.md`, `docs/versioning.md`, `docs/review-checklist.md`
20+
- Added `project-skill-creator` skill for safe project-managed skill creation
21+
22+
## Breaking Changes
23+
24+
- None expected for consumers using skills as markdown definitions.
25+
26+
## Migration Notes
27+
28+
- Provider-specific metadata files are not allowed in this repo.
29+
- Skill definitions should be stored using the unified `.chalk/skills` architecture.
30+
- All core skills are now Chalk-managed (`owner: chalk`).
31+
32+
## Validation
33+
34+
Before publishing changes, run:
35+
36+
```bash
37+
make validate
38+
```
39+
40+
## Follow-ups
41+
42+
- Move from individual CODEOWNERS to org/team ownership once org setup is finalized.

0 commit comments

Comments
 (0)