Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
63 lines (43 loc) · 2.42 KB

CONTRIBUTING.md

File metadata and controls

63 lines (43 loc) · 2.42 KB
Raw

Contributing

Thanks for adding a skill. Skills are short Markdown files; you don't need to write any code.

How to contribute

  1. Fork the repository.
  2. Add a folder {country}/{practice}/skills/{slug}/ with a SKILL.md inside. Use the template below.
  3. If the plugin {country}/{practice}/ doesn't exist yet, also add plugin.json, CLAUDE.md, and README.md in its root (copy from ru/arbitration/ as a reference).
  4. Open a pull request. CI runs the schema, license, and version checks; a maintainer reviews and merges.

SKILL.md template

---
name: my-skill
title: My Skill
description: One-paragraph description of what the skill does and when to use it (40–2000 chars). This shows up in the marketplace and in semantic discovery.
author: Your Name
author_url: https://github.com/yourhandle
license: Apache-2.0
version: 0.1.0
execution_mode: open
jurisdiction: us
practice: corporate
language: en
tags: [tag-one, tag-two]
---

# Skill title

## When to apply

Triggers, example user prompts, what's out of scope.

## Algorithm

Step-by-step instructions for the orchestrator.

## Output contract

What the answer must contain (citations, disclaimer, etc.).

title is the human-readable display name shown on the marketplace card — the same text you put in the body's H1 (# Skill title), just promoted to machine-readable frontmatter. It's optional; if omitted, consumers fall back to the H1, then to name.

The canonical contract is schemas/skill-frontmatter.schema.json.

Rules CI enforces

  • License. Must be one of: Apache-2.0, MIT, BSD-3-Clause, BSD-2-Clause, CC0-1.0, CC-BY-4.0. AGPL / GPL / CC-NC / CC-ND are rejected automatically.
  • execution_mode. Must be open in this repository.
  • Path consistency. name matches the folder name; jurisdiction and practice match the path.
  • Versioning. version follows semver (MAJOR.MINOR.PATCH). Bump it on every change to SKILL.md.
  • References. If you cite local source texts, put them under references/ inside the skill folder and list them in the sources frontmatter array.

Contribution license

By opening a pull request you license your contribution under Apache License 2.0 (same as the repository).

No exclusivity

You keep all rights to your skill and can publish it elsewhere — in your own repository, in a private deployment — without notifying us.