Initial commit: homelab infrastructure wiki
- Full Obsidian vault content - Host configs (ice, grizzley, ubuntu, proxmox, truenas, panda, hyte) - Media stack documentation - Traefik HA setup - Automation scripts - Bachelor party planning
This commit is contained in:
56
homelab/raw/articles/forge/reference/docs-skills.md
Normal file
56
homelab/raw/articles/forge/reference/docs-skills.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
type: agent-doc
|
||||
agent: ForgeCode
|
||||
source: https://forgecode.dev/docs/skills/
|
||||
scraped: 2026-04-28T21:02:23.680487+00:00
|
||||
content_hash: 5f2e8076
|
||||
---
|
||||
# SKILL.md
|
||||
|
||||
Skills are reusable workflows you teach ForgeCode once. Write the process down in a SKILL.md file and place any supporting scripts, examples, or other resources alongside it — ForgeCode will automatically load the right skill whenever the task calls for it.
|
||||
|
||||
## Getting Started
|
||||
|
||||
Skills can live in three places:
|
||||
|
||||
- Project skills — .forge/skills/<skill-name>/SKILL.md inside your project, checked into version control and shared with your team.
|
||||
- Agents skills — ~/.agents/skills/<skill-name>/SKILL.md on your machine, shared with any agent tool that follows the common agents convention.
|
||||
- Global skills — ~/forge/skills/<skill-name>/SKILL.md on your machine, available across every project you work on.
|
||||
|
||||
Each skill is a plain markdown file — write it the same way you'd explain the process to a new teammate.
|
||||
|
||||
```
|
||||
.forge/ # project skills (highest precedence)└── skills/ └── release-notes/ └── SKILL.md~/.agents/ # agents skills (shared across agent tools)└── skills/ └── release-notes/ └── SKILL.md~/forge/ # global skills (all projects)└── skills/ └── release-notes/ └── SKILL.md
|
||||
```
|
||||
|
||||
When multiple sources define a skill with the same name, the one with higher precedence wins: project > agents > global > built-in.
|
||||
|
||||
Here's what a release notes skill looks like:
|
||||
|
||||
```
|
||||
# Generate Release Notes1. Run `./scripts/get-commits.sh` to collect commits since the last tag2. Run `./scripts/categorize.sh` to group them into Features, Bug Fixes, and Breaking Changes3. Write the release notes in `CHANGELOG.md` using the output from the scripts4. Run `./scripts/validate-changelog.sh` to confirm the format is correct
|
||||
```
|
||||
|
||||
ForgeCode reads all skills at the start of a session and automatically applies the relevant one based on what you're asking it to do — no need to invoke them by name.
|
||||
|
||||
The easiest way to create a skill is to ask ForgeCode directly. Describe the workflow — the steps, scripts, and edge cases — and it will generate the SKILL.md in the right place:
|
||||
|
||||
```
|
||||
Create a release-notes skill. It should collect all commits since the last tag,group them by type — Features, Bug Fixes, Breaking Changes — write the notes tothe changelog, and run a validation check at the end.
|
||||
```
|
||||
|
||||
Review the generated file, adjust anything that doesn't match your setup, and it's ready to use. The more detail you give, the better the skill.
|
||||
|
||||
## Importing Claude Code Skills
|
||||
|
||||
Skills are fully compatible with Claude Code. The SKILL.md format is identical — no conversion needed.
|
||||
|
||||
They work without any changes.
|
||||
|
||||
## Verifying Your Skills
|
||||
|
||||
To confirm ForgeCode has picked up your skills, run :skill in the chat. You'll see a list of all available skills along with their descriptions.
|
||||
|
||||
```
|
||||
:skill
|
||||
```
|
||||
Reference in New Issue
Block a user