Skip to content
Skills Library
Programming · Building & coding

ossify

/ossify

Set up and maintain the open-source conventions of a repo. Creates AGENTS.md with a CLAUDE.md symlink holding commit, push, and release rules; writes English and Korean READMEs with a language switch and an optional generated banner; and cuts releases with version bumps, CHANGELOG, git tags, and GitHub releases. Use when the user says "오픈소스로 만들 준비", "AGENTS.md 만들어줘", "CLAUDE.md 심볼릭 링크", "릴리스 해줘", "태그 달아줘", "README 써줘", "make this repo open-source ready", "cut a release", or starts a new public repo.

Repository
ossify ↗
Licence
MIT
Last repository change
06.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
5
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 06.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Set up and maintain the open-source conventions of a repo. Creates AGENTS.md with a CLAUDE.md symlink holding commit, push, and release rules; writes English and Korean READMEs with a language switch and an optional generated banner; and cuts releases with version bumps, CHANGELOG, git tags, and GitHub releases. Use when the user says "오픈소스로 만들 준비", "AGENTS.md 만들어줘", "CLAUDE.md 심볼릭 링크", "릴리스 해줘", "태그 달아줘", "README 써줘", "make this repo open-source ready", "cut a release", or starts a new public repo.

Triggers from the description

오픈소스로 만들 준비AGENTS.md 만들어줘CLAUDE.md 심볼릭 링크릴리스 해줘태그 달아줘README 써줘make this repo open-source readycut a release

Arguments

/ossify [init | adopt | readme | release] [path]
Original author description

Set up and maintain the open-source conventions of a repo. Creates AGENTS.md with a CLAUDE.md symlink holding commit, push, and release rules; writes English and Korean READMEs with a language switch and an optional generated banner; and cuts releases with version bumps, CHANGELOG, git tags, and GitHub releases. Use when the user says "오픈소스로 만들 준비", "AGENTS.md 만들어줘", "CLAUDE.md 심볼릭 링크", "릴리스 해줘", "태그 달아줘", "README 써줘", "make this repo open-source ready", "cut a release", or starts a new public repo.

How it works

  1. Modes
  2. Step 1. Inspect the repo
  3. Step 2. Agent rules (init, adopt)
  4. Step 3. READMEs (init, adopt, readme)
  5. Step 4. Base files (init, adopt)
  6. Step 5. Privacy scan (before any first push)
  7. Step 6. Commit and push
  8. Step 7. Release (release mode, or the first release after init)
  9. Report
Original SKILL.md headings · 81 lines, 624 words
SKILL.md preview
---
name: ossify
description: Set up and maintain the open-source conventions of a repo. Creates AGENTS.md with a CLAUDE.md symlink holding commit, push, and release rules; writes English and Korean READMEs with a language switch and an optional generated banner; and cuts releases with version bumps, CHANGELOG, git tags, and GitHub releases. Use when the user says "오픈소스로 만들 준비", "AGENTS.md 만들어줘", "CLAUDE.md 심볼릭 링크", "릴리스 해줘", "태그 달아줘", "README 써줘", "make this repo open-source ready", "cut a release", or starts a new public repo.
argument-hint: "[init | adopt | readme | release] [path]"
---

# ossify

Three conventions, applied the same way in every repo:

1. **Agent rules**: `AGENTS.md` is the single source of truth; `CLAUDE.md` is a symlink to it. It tells every agent to commit and push after every change and to release only when what users install changes.
2. **Releases**: semantic version bump in every version file, a CHANGELOG entry, an annotated tag, and a GitHub release.
3. **READMEs**: `README.md` in English and `README.ko.md` in Korean, linked to each other, kept in sync, written to a fixed structure.

## Modes

Infer the mode. Do not ask.

| Situation | Mode |
|---|---|
| empty or new folder, "새 레포", "init" | **init** |
| existing repo without these conventions | **adopt** |
| "README 써줘 / 고쳐줘" | **readme** |
| "릴리스", "태그", "배포", or a finished distribution change in a repo that already has `AGENTS.md` | **release** |

## Step 1. Inspect the repo

Find, without changing anything:

- **project type and version files**: see `references/project-types.md` (Claude Code plugin, npm, Python, Rust, Go, Swift, generic)
- **distribution paths**: the files whose change alters what users install
- existing `AGENTS.md`, `CLAUDE.md`, `README*`, `CHANGELOG.md`, `LICENSE`
- git state: `git status --short --branch`, remote, latest tag (`git describe --tags --abbrev=0`)
- GitHub login: `gh api user --jq .login`

## Step 2. Agent rules (init, adopt)

Write `AGENTS.md` from `references/agents-template.md`, filled with the real layout, version files, distribution paths, and validation command for this repo. Then link:

```bash
ln -s AGENTS.md CLAUDE.md
```

Existing files are never overwritten blindly:
- `CLAUDE.md` exists as a regular file: move its project-specific content into `AGENTS.md` (keep every rule, drop duplicates), then replace it with the symlink.
- `AGENTS.md` exists: merge the ossify sections into it; keep the owner's rules.
- Both exist and differ: merge both into `AGENTS.md`, then link.

Report every merge in one line each.

## Step 3. READMEs (init, adopt, readme)

Follow `references/readme-rules.md`. In short: English `README.md` and Korean `README.ko.md`, same structure, language switch under the banner, real examples only, install commands copied from what actually works.

Banner: if `assets/banner.png` does not exist, generate one in the background at the start of this step (`references/readme-rules.md#banner`). Look at it before committing. Skip silently only if no image tool is available, and say so in the report.

## Step 4. Base files (init, adopt)

Add only what is missing: `LICENSE` (MIT unless told otherwise, holder = GitHub login, current year), `CHANGELOG.md` with an `Unreleased` section, `.gitignore` for the project type.

## Step 5. Privacy scan (before any first push)

Grep for employer and internal project names, emails, home paths, tokens, and anything from the user's private instructions. Zero hits before the first public commit.

## Step 6. Commit and push

One logical change per commit, imperative subject, the session's attribution line if one is configured. Push right away. If there is no remote and the user asked to publish, create it: `gh repo create <owner>/<name> --public --source . --push`. Otherwise ask once before creating a public repo.

## Step 7. Release (release mode, or the first release after init)

Follow `references/release.md`:

1. working tree clean, on the default branch, up to date
2. decide the bump from changes since the last tag (patch: fixes and tweaks; minor: new features; major: breaking)
3. update every version file found in Step 1, move `Unreleased` into the new version in `CHANGELOG.md`
4. commit `Release vX.Y.Z`, push
5. `git tag -a vX.Y.Z -m "vX.Y.Z"`, push the tag
6. `gh release create vX.Y.Z --title "vX.Y.Z" --notes-file <notes from CHANGELOG>`
7. verify the tag and release exist

Docs-only changes never trigger a release.

## Report

Short: what was created or merged, the symlink, the release URL if any, and every judgment call made instead of asking.
Files in this package (5)
  • SKILL.md 5 KB
  • references/agents-template.md 2 KB
  • references/project-types.md 2 KB
  • references/readme-rules.md 3 KB
  • references/release.md 2 KB

Versions

The database has no other skills named ossify.

Database snapshot: 13.11.2026 · package version c157d63c9d42 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100open-source-ready
    Gets a GitHub repository ready to make public, following its owner's conventions from their .github repo and other public repos - license and NOTICE, contributing and changelog, issue templates, Dependabot, a secret and history scan, README, tests and CI, a release - then stops…
  • 95release-manager
    Create new AILANG releases with version bumps, changelog updates, git tags, and CI/CD verification. Use when user says "ready to release", "create release", mentions version numbers, or wants to publish a new version.
  • 100create-release-workflow
    Use when creating a new release — drafting a changelog entry, creating git tags, publishing via GitHub Releases, or updating README install examples to pin to the latest tagged version.
  • 100public-repo
    Open-source a project or an agent skill as a public GitHub repository with nothing private in its files, file names, history, commit identities or settings, working on its own from a fresh clone, and keep it clean on every later push. Use when asked to make a repo public,…
  • 100create-release
    Automate semantic version releases across project types by detecting version files, bumping versions, updating changelogs, creating git tags, and optionally publishing GitHub releases. Use when users ask to cut a release, bump the version, prepare a new version, tag a release,…
  • 100backfill-releases
    Creates the missing git tags and GitHub releases for every version a beachball-published repository has already shipped, from its CHANGELOG.json files. Use when moving a repository onto GitHub releases, or when asked to backfill releases or tag old versions. Runs only when invoked by name.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.