---
title: "Author a Skill for your project · skilld"
description: "Draft a Skill from your repository's commands, conventions, and workflows. Review it, then keep it in the repository so any agent can run it."
canonical_url: "https://skilld.dev/learn/author-project-skills"
last_updated: "2026-09-08T07:50:51.963Z"
meta:
  "og:description": "Draft a Skill from your repository's commands, conventions, and workflows. Review it, then keep it in the repository so any agent can run it."
  "og:image": "https://skilld.dev/_og/d/a_~c2tpbGxkLCBhZ2VudCBza2lsbHMgd3JpdHRlbiBieSByZWFsIG1haW50YWluZXJz%2Cc_Page.takumi%2Cdescription_~Q3VyYXRlZCBhZ2VudCBza2lsbHMgYnkgaHVtYW5zLCB3cml0dGVuIGJ5IHJlYWwgbWFpbnRhaW5lcnMgaW4gdGhlaXIgb3duIEdpdEh1YiByZXBvcw%2Cp_Ii9sZWFybi9hdXRob3ItcHJvamVjdC1za2lsbHMi%2Cs_vwAdHDcMe-8h_l_C.png"
  "og:image:alt": "skilld, agent skills written by real maintainers"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Author a Skill for your project"
  "twitter:image": "https://skilld.dev/_og/d/a_~c2tpbGxkLCBhZ2VudCBza2lsbHMgd3JpdHRlbiBieSByZWFsIG1haW50YWluZXJz%2Cc_Page.takumi%2Cdescription_~Q3VyYXRlZCBhZ2VudCBza2lsbHMgYnkgaHVtYW5zLCB3cml0dGVuIGJ5IHJlYWwgbWFpbnRhaW5lcnMgaW4gdGhlaXIgb3duIEdpdEh1YiByZXBvcw%2Cp_Ii9sZWFybi9hdXRob3ItcHJvamVjdC1za2lsbHMi%2Cs_vwAdHDcMe-8h_l_C.png"
  "twitter:image:alt": "skilld, agent skills written by real maintainers"
---

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

# **Author a Skill for your project**

Draft a Skill from your repository's commands, conventions, and workflows. Review it, then keep it in the repository so any agent can run it.

Authoring guide

## 1. Draft your Skill

Project Skill

[Change setup](https://skilld.dev/make-skill)

Open your agent at the repository root. Give it these instructions to draft your Skill.

[Read the authoring Skill](https://raw.githubusercontent.com/skilld-dev/skilld/main/skills/generate-project-skill/SKILL.md)

Read https://raw.githubusercontent.com/skilld-dev/skilld/main/skills/generate-project-skill/SKILL.md. Draft a Skill for this project using this repository. Read the project instructions, the manifests, and the test, lint, build, and release commands. Show the draft for review before replacing existing Skills.

Point your agent at the repository root. Ask it to save the draft in `**skills/your-skill/SKILL.md**`.

Describe the work the Skill covers: the commands to run, the files to read first, and the rules agents break most often. Point to source files instead of copying them. Name the directories an agent must not edit.

## 2. Review the draft

Run each command the Skill lists and check the outcome it records. Use [**the cross-Agent checks**](https://skilld.dev/learn/create-agent-skills#check-selection-and-task-completion-separately) to test selection, missing inputs and task completion. Use the [**authoring Skill's quality checks**](https://github.com/skilld-dev/skilld/tree/main/skills/generate-project-skill) before committing.

## 3. Keep the Skill in the repository

Commit the reviewed Skill. [**GitHub**](https://github.com) is the source of truth, and skilld.dev reads the Skill from one exact commit. Any dev with access to the repository can run it:

```bash
npx skilld run owner/repo/your-skill
```

Replace `**owner/repo**` with your repository and `**your-skill**` with the Skill directory name. Put the command in your README so contributors can find it. For a private repository, see [**Use Skills from private Repositories**](https://skilld.dev/learn/private-repositories).

## 4. Keep it current

When a command or convention changes, review the Skill alongside the change. Run the authoring Skill again when the project structure moves.

```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/learn/author-project-skills#webpage","@type":"WebPage","description":"Draft a Skill from your repository's commands, conventions, and workflows. Review it, then keep it in the repository so any agent can run it.","name":"Author a Skill for your project","url":"https://skilld.dev/learn/author-project-skills","isPartOf":{"@id":"https://skilld.dev/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://skilld.dev/learn/author-project-skills"]}]}]}
```