---
title: "Skillgen · skilld"
description: "Keep your package skill current. After each release tag, Skillgen opens a pull request that updates the Skill in your repository."
canonical_url: "https://skilld.dev/skillgen"
meta:
  "og:description": "Keep your package skill current. After each release tag, Skillgen opens a pull request that updates the Skill in your repository."
  "og:image": "https://skilld.dev/_og/d/a_Skillgen%2Cc_Page.takumi%2Ctitle_Skillgen%2Cdescription_~S2VlcCB5b3VyIHBhY2thZ2Ugc2tpbGwgY3VycmVudC4gQWZ0ZXIgZWFjaCByZWxlYXNlIHRhZywgU2tpbGxnZW4gb3BlbnMgYSBwdWxsIHJlcXVlc3QgdGhhdCB1cGRhdGVzIHRoZSBTa2lsbCBpbiB5b3VyIHJlcG9zaXRvcnku%2Cp_Ii9za2lsbGdlbiI%2Cs_Rp61oMji4f4VBmaT.png"
  "og:image:alt": Skillgen
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": Skillgen
  "twitter:image": "https://skilld.dev/_og/d/a_Skillgen%2Cc_Page.takumi%2Ctitle_Skillgen%2Cdescription_~S2VlcCB5b3VyIHBhY2thZ2Ugc2tpbGwgY3VycmVudC4gQWZ0ZXIgZWFjaCByZWxlYXNlIHRhZywgU2tpbGxnZW4gb3BlbnMgYSBwdWxsIHJlcXVlc3QgdGhhdCB1cGRhdGVzIHRoZSBTa2lsbCBpbiB5b3VyIHJlcG9zaXRvcnku%2Cp_Ii9za2lsbGdlbiI%2Cs_Rp61oMji4f4VBmaT.png"
  "twitter:image:alt": Skillgen
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

[Make a skill](https://skilld.dev/make-skill)

# **Skillgen **

Keep your package skill current. After each release tag, Skillgen opens a pull request that updates the Skill in your repository. You review it and decide what merges.

## **Set up Skillgen **

1. 01 ### **Check your repository **
   - A public GitHub repository with a published npm package. Its `package.json` sits at the root, or in a monorepo under `packages/<name>/`. Skillgen supports npm packages only.
   - A Skill in `skills/<name>/SKILL.md` beside that `package.json`. A root package may keep one `SKILL.md` at the root instead.
   - Up to 9 files and 64 KiB in total: `SKILL.md` and Markdown files under `references/`.
   - Release tags that match the package version, such as `1.4.0`, `v1.4.0` or `name@1.4.0`. If one tag releases several packages with Skills, each gets its own pull request. A tag older than the version on your default branch, such as a maintenance release, starts no run.
   - npm links each version to its tag commit, through provenance or `gitHead`. [No Skill yet? Make a skill](https://skilld.dev/make-skill)
2. 02 ### **Turn it on for each repository **

   Sign in to skilld with GitHub. Your account lists the public repositories you maintain that have a Skill. Turn Skillgen on for each one it should update. Skillgen never runs on a repository you did not turn on. [Choose repositories](https://skilld.dev/me?view=skillgen)
3. 03 ### **Install the App **

   On GitHub, choose ****Only select repositories****, then pick the repositories you turned on. [Install Skillgen](https://github.com/apps/skilld-skillgen/installations/new)
   - ****Contents: write.**** Skillgen pushes one branch for each release.
   - ****Pull requests: write.**** Skillgen opens the pull request.
   - It asks for no Actions, administration, or issues access.
4. 04 ### **Review the pull request **

   Skillgen starts with your latest tag when you install the App. If you turned the repository on after the install, it starts at your next tag. Each new tag starts another run. If npm has not published the version yet, the run waits. Each run must finish within an hour of starting.

   A model drafts the update from the tagged source with the skilld Harness. A separate review must accept it before anything reaches your repository. If the Skill needs no change, Skillgen opens nothing.

   Look for a pull request titled `docs(skills): update for v1.4.0`. It changes only your Skill's folder. Skillgen never overwrites a branch that already exists. You decide what merges.

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://skilld.dev/#website","@type":"WebSite","description":"Curated agent skills by humans, written by real maintainers in their own GitHub repos","name":"skilld","url":"https://skilld.dev/"},{"@id":"https://skilld.dev/skillgen#webpage","@type":"WebPage","description":"Keep your package skill current. After each release tag, Skillgen opens a pull request that updates the Skill in your repository.","name":"Skillgen","url":"https://skilld.dev/skillgen","isPartOf":{"@id":"https://skilld.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://skilld.dev/skillgen"]}]}]}
```