openskillmd 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenSkill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# osm — the OpenSkill CLI
+
+Search, add, score, and explore AI agent skills, blueprints, and MCP servers from
+[OpenSkill.md](https://openskill.md) — right from your terminal.
+
+```bash
+npm i -g @openskillmd/osm@beta
+# or the unscoped alias:
+npm i -g openskillmd@beta
+```
+
+Both packages install the same CLI and expose the `osm` command (plus `openskill`
+and `openskillmd` aliases).
+
+> **Beta:** the current release is published under the `beta` dist-tag and points at
+> the staging API — install it with the `@beta` tag shown above. A plain
+> `npm i -g @openskillmd/osm` will not resolve until the stable `latest` release
+> lands when the production API goes live.
+
+## Usage
+
+```bash
+osm search <query>            # Search skills, blueprints, and MCP servers
+osm info <slug>               # Show details about a skill or blueprint
+osm add <owner>/<repo>        # Add a skill from a source repo (alias: install)
+osm add <owner>/<repo>@<skill>
+osm browse                    # Explore collections & MCP servers (interactive)
+osm list                      # Show skills installed in this project
+osm score <file>              # Score a local SKILL.md for quality
+osm init <skill|blueprint>    # Scaffold a new skill or blueprint
+osm remove <slug>             # Remove an installed skill/blueprint
+osm router install            # Install the OpenSkill router SKILL.md
+osm mcp setup                 # Print MCP server config for Claude/Cursor
+osm mcp info <slug>           # Show details about an MCP server
+```
+
+### Installing skills
+
+`osm add` installs skills from a source repository (it delegates to the
+[`skills`](https://www.npmjs.com/package/skills) installer and is agent-aware):
+
+```bash
+osm add anthropics/skills@frontend-design
+osm add anthropics/skills@frontend-design --agent claude-code
+osm add anthropics/skills --global --copy
+```
+
+Run `osm search <query>` to discover skills, then `osm info <slug>` — the install
+hint shows the exact `osm add owner/repo` command for that skill.
+
+## Configuration
+
+Settings live in `~/.openskill/config.json`:
+
+```json
+{ "baseUrl": "https://staging.openskill.md/api" }
+```
+
+The API base URL is resolved in this order:
+
+1. `OPENSKILL_API_URL` environment variable
+2. `baseUrl` in `~/.openskill/config.json`
+3. the built-in default (staging during beta)
+
+```bash
+OPENSKILL_API_URL=http://localhost:8080/api osm search testing
+```
+
+## Coming soon
+
+Authenticated publishing (`osm login` / `osm publish`) is in development and not
+available in this release.
+
+## License
+
+MIT