Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@
"name": "Kumar Adarsh Pandita",
"url": "https://github.com/forkadarshp"
},
"homepage": "https://github.com/forkadarshp/MPort",
"repository": "https://github.com/forkadarshp/MPort",
"homepage": "https://github.com/forkadarshp/modelport",
"repository": "https://github.com/forkadarshp/modelport",
"license": "MIT",
"keywords": ["model-migration", "llm-migration", "prompt-migration", "model-upgrade", "breaking-changes", "evals"]
}
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# ModelPort

[![CI](https://github.com/forkadarshp/MPort/actions/workflows/ci.yml/badge.svg)](https://github.com/forkadarshp/MPort/actions/workflows/ci.yml)
[![CI](https://github.com/forkadarshp/modelport/actions/workflows/ci.yml/badge.svg)](https://github.com/forkadarshp/modelport/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Agent Skill](https://img.shields.io/badge/Agent-Skill-111827)](SKILL.md)
[![Models](https://img.shields.io/badge/Claude_5.x_·_GPT--6_·_Gemini_3.8-guides-blue)](references/models/INDEX.md)
[![Models](https://img.shields.io/badge/Claude_5.x_·_GPT--6_·_Gemini_3.8-guides-blue)](#supported-models)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

![ModelPort social preview](assets/social-preview.svg)
Expand All @@ -15,7 +15,7 @@ prompts, tool definitions, API calls, and tests around a model swap, using
per-model guides that track each provider's breaking changes. Then it proves the
upgrade worked with tests, a live smoke check, and optional old-vs-new evals.

> **Install:** `npx skills add forkadarshp/MPort`, then tell your agent
> **Install:** `npx skills add forkadarshp/modelport`, then tell your agent
> *"migrate this repo to claude-opus-5-5"*. See [Quickstart](#quickstart).

## Seen one of these after a model swap?
Expand Down Expand Up @@ -145,12 +145,12 @@ sends parameters they reject and leaves room for always-on thinking. Details in

```bash
# Any agent (Claude Code, Codex, Cursor, and others)
npx skills add forkadarshp/MPort
npx skills add forkadarshp/modelport
```

```text
# Claude Code, as a plugin
/plugin install modelport --marketplace forkadarshp/MPort
/plugin install modelport --marketplace forkadarshp/modelport
```

**2. Ask.** In your project, tell the agent where you are going:
Expand Down Expand Up @@ -196,8 +196,8 @@ If you prefer to fork and modify the skill locally:
Clone:

```bash
git clone https://github.com/forkadarshp/MPort.git
cd MPort
git clone https://github.com/forkadarshp/modelport.git
cd modelport
```

Install as a local skill with a symlink (Codex example):
Expand Down Expand Up @@ -436,9 +436,9 @@ reports a leaderboard with quality, latency, cost, and contract metrics. See

### Does it work with Claude Code, Codex, and Cursor?

Yes. Install it with `npx skills add forkadarshp/MPort` for any compatible
Yes. Install it with `npx skills add forkadarshp/modelport` for any compatible
agent, or as a Claude Code plugin with
`/plugin install modelport --marketplace forkadarshp/MPort`.
`/plugin install modelport --marketplace forkadarshp/modelport`.

### Do I need an API key or an account?

Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
If you discover a security issue, please do not open a public issue first.

Report vulnerabilities through
[GitHub Security Advisories](https://github.com/forkadarshp/MPort/security/advisories/new)
[GitHub Security Advisories](https://github.com/forkadarshp/modelport/security/advisories/new)
so the report stays private until a fix is ready.

Include:
Expand Down
2 changes: 1 addition & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
Upgrade LLM code to Claude Opus 5.5, GPT-6, or Gemini 3.8 without breaking
prod. Breaking changes, fixes, and an agent skill that applies them.
url: https://forkadarshp.github.io
baseurl: /MPort
baseurl: /modelport
theme: jekyll-theme-primer
plugins:
- jekyll-seo-tag
Expand Down
Binary file modified assets/social-preview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion assets/social-preview.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 23 additions & 19 deletions docs/PUBLISHING.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,33 +81,37 @@ Keep both working. Test them after any change to `SKILL.md` or the manifests.

| Channel | User command | Check |
| :------ | :----------- | :---- |
| Skills CLI (any agent) | `npx skills add forkadarshp/MPort` | `npx skills add . --list` finds one skill |
| Claude Code plugin | `/plugin install modelport --marketplace forkadarshp/MPort` | `claude plugin validate .` passes |

Listing on skills.sh: <https://skills.sh/forkadarshp/mport/modelport-skill>.
On 2026-10-11 it showed 1 install and "No SKILL.md available for this skill",
so the page had no description. The raw `SKILL.md` URL resolves, so the cause is
on the directory side or a stale snapshot. Re-check after the next release and
report it to the skills.sh maintainers if it persists.
| Skills CLI (any agent) | `npx skills add forkadarshp/modelport` | `npx skills add . --list` finds one skill |
| Claude Code plugin | `/plugin install modelport --marketplace forkadarshp/modelport` | `claude plugin validate .` passes |

Listing on skills.sh: the directory keys pages by repo path, so the rename on
2026-10-11 starts a new page at
<https://skills.sh/forkadarshp/modelport/modelport-skill> once someone installs
from the new path. The old page,
<https://skills.sh/forkadarshp/mport/modelport-skill>, showed 1 install and "No
SKILL.md available for this skill" on that date, so it had no description. The
raw `SKILL.md` URL resolves, so the cause is on the directory side or a stale
snapshot. Check the new page after the first install and report it to the
skills.sh maintainers if the description is still missing.

Wider reach for the plugin: submit it to Anthropic's plugin directory (see
"Submit to Anthropic's directory" in the Claude Code plugin docs).

## Website (GitHub Pages)

`_config.yml` makes the repo root a Jekyll site, so every guide becomes its own
indexable page with a title taken from its first heading. Pages is off until
you enable it: Settings, Pages, deploy from branch `main`, folder `/`. Then set
the repo homepage to the site URL and confirm the build passed under Actions.
The config has not been built locally, so check the first build.
indexable page with a title taken from its first heading. Pages deploys from
branch `main`, folder `/`, to <https://forkadarshp.github.io/modelport/>, which
is also the repo homepage. Each push to `main` rebuilds the site; a failed
build shows under Actions as "pages build and deployment".

## Naming

The repo is `MPort`, the product is ModelPort, and the skill is
`modelport-skill`. Nobody searches for "MPort". Renaming the repo to
`modelport` puts the search term in the URL and in the install command. GitHub
redirects the old URL, but update the README, the manifests, `_config.yml`, and
this file in the same change.
The repo is `modelport`, the product is ModelPort, and the skill is
`modelport-skill`. The repo was called `MPort` until 2026-10-11. GitHub
redirects the old URL, so old links and `npx skills add forkadarshp/MPort` keep
working, but do not create a new repo named `MPort` under the same account:
that would break the redirect.

## Distribution

Expand Down Expand Up @@ -150,7 +154,7 @@ illustrative; --provider anthropic gives measured ones.

Guides carry a verified-on date and a source, and CI flags stale ones.

https://github.com/forkadarshp/MPort
https://github.com/forkadarshp/modelport
```

### Draft: thread
Expand All @@ -166,7 +170,7 @@ https://github.com/forkadarshp/MPort
references/breaking-changes.md

3/ ModelPort is an agent skill that applies those fixes for you, in order, and
ends with tests, a smoke check and rollback notes. npx skills add forkadarshp/MPort
ends with tests, a smoke check and rollback notes. npx skills add forkadarshp/modelport
```

## Measure
Expand Down
Loading