<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Stevesadr</title>
    <description>The latest articles on DEV Community by Stevesadr (@stevesadr).</description>
    <link>https://dev.to/stevesadr</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4257551%2Fbdcef32e-91b5-427b-88bf-5610a6e6d071.jpg</url>
      <title>DEV Community: Stevesadr</title>
      <link>https://dev.to/stevesadr</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/stevesadr"/>
    <language>en</language>
    <item>
      <title>Your SKILL.md is portable. Is its behavior? Introducing Skillporter</title>
      <dc:creator>Stevesadr</dc:creator>
      <pubDate>Sat, 21 Nov 2026 17:27:13 +0000</pubDate>
      <link>https://dev.to/stevesadr/your-skillmd-is-portable-is-its-behavior-introducing-skillporter-17m5</link>
      <guid>https://dev.to/stevesadr/your-skillmd-is-portable-is-its-behavior-introducing-skillporter-17m5</guid>
      <description>&lt;p&gt;Several coding agents use skills built around a &lt;code&gt;SKILL.md&lt;/code&gt; file, often alongside scripts, references, and assets.&lt;/p&gt;

&lt;p&gt;That makes moving a skill look straightforward: copy the directory into another agent’s skills folder.&lt;/p&gt;

&lt;p&gt;But copying the files only answers one question: &lt;strong&gt;did the files arrive?&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;It doesn’t tell you whether the destination agent interprets the skill the same way.&lt;/p&gt;

&lt;p&gt;I’m building &lt;strong&gt;&lt;a href="https://github.com/Stevesadr/skillporter" rel="noopener noreferrer"&gt;Skillporter&lt;/a&gt;&lt;/strong&gt;, an open-source CLI that converts agent skills and reports what changes along the way.&lt;/p&gt;

&lt;h2&gt;
  
  
  A shared file format still leaves room for differences
&lt;/h2&gt;

&lt;p&gt;A skill can contain more than instructions. Its frontmatter and companion files may describe tool permissions, invocation behavior, or features specific to its original host.&lt;/p&gt;

&lt;p&gt;When moving that skill, there are several things to check:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Does the destination discover it in the expected directory?&lt;/li&gt;
&lt;li&gt;Does it recognize the frontmatter fields?&lt;/li&gt;
&lt;li&gt;Does a recognized field actually affect behavior?&lt;/li&gt;
&lt;li&gt;Does the skill depend on hooks or scripts tied to its original agent?&lt;/li&gt;
&lt;li&gt;Are command references in the instructions still meaningful?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A conversion can preserve every byte and still leave work for the person migrating it.&lt;/p&gt;

&lt;p&gt;That’s why Skillporter produces a report alongside the converted skill.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the report tells you
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fb8xzvzbyee1pti9lyqbn.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fb8xzvzbyee1pti9lyqbn.png" alt="Skillporter dry-run conversion report for report-builder from Claude Code to Codex CLI: nine entries preserved, four degraded, none dropped, and no destination files written." width="800" height="680"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;A visual presentation of a dry-run report for the report-builder fixture, converting from Claude Code to Codex CLI.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;This example has &lt;strong&gt;nine preserved entries and four degraded entries&lt;/strong&gt;, with nothing dropped. These are report entries, not a count of files.&lt;/p&gt;

&lt;p&gt;The body and companion files are preserved. The report flags &lt;code&gt;allowed-tools&lt;/code&gt; and a custom &lt;code&gt;x-acme-owner&lt;/code&gt; field because their behavior is not verified in the target profile. It also flags two shell placeholders: text that expanded in the source agent becomes text the destination model reads.&lt;/p&gt;

&lt;p&gt;That distinction matters. A field can remain in the file while its effect is uncertain or different.&lt;/p&gt;

&lt;p&gt;Because this is a dry run, no destination files are written. The report describes the planned conversion.&lt;/p&gt;

&lt;h2&gt;
  
  
  Preview a migration before installing it
&lt;/h2&gt;

&lt;p&gt;Skillporter currently has profiles for Claude Code, Codex CLI, OpenCode, DeepSeek Harness, and Kimi Code. A separate Claude.ai / Skills API upload profile is partial.&lt;/p&gt;

&lt;p&gt;The examples below use version &lt;code&gt;0.1.0&lt;/code&gt; and require Node.js &lt;code&gt;22.20.0&lt;/code&gt; or newer:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install --global @skillporter/cli@0.1.0
skillporter agents
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you have a Claude Code skill at &lt;code&gt;.claude/skills/my-skill&lt;/code&gt;, preview a conversion to Codex CLI:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;skillporter convert ./.claude/skills/my-skill \
  --from claude-code \
  --to codex-cli \
  --dry-run
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Replace &lt;code&gt;my-skill&lt;/code&gt; with the name of an existing skill.&lt;/p&gt;

&lt;p&gt;The report classifies fields and features as:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Status&lt;/th&gt;
&lt;th&gt;Meaning&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;preserved&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Carried over unchanged&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;adapted&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Changed to fit the destination&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;renamed&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Mapped to the destination’s spelling&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;degraded&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Retained, but its effect is reduced or unknown&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;dropped&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Omitted because it cannot be represented&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Once you’ve reviewed the report, run this from the destination project, with the source path adjusted if needed, to install the skill:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;skillporter convert ./.claude/skills/my-skill \
  --from claude-code \
  --to codex-cli \
  --install \
  --project
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;For this target, the installed directory is &lt;code&gt;.agents/skills/my-skill&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Add &lt;code&gt;--strict&lt;/code&gt; to reject planned losses or staged lint errors before changing a destination.&lt;/p&gt;

&lt;p&gt;For &lt;code&gt;convert&lt;/code&gt;, exit code &lt;code&gt;2&lt;/code&gt; means the conversion has losses; it does not necessarily mean the files could not be written. In a dry run, it signals losses in the planned conversion.&lt;/p&gt;

&lt;h2&gt;
  
  
  Sometimes you only need a compatibility check
&lt;/h2&gt;

&lt;p&gt;You can also inspect a skill or lint it for a target without converting it:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;skillporter inspect ./.claude/skills/my-skill \
  --from claude-code

skillporter lint ./.claude/skills/my-skill \
  --from claude-code \
  --for codex-cli
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;These commands read the skill without executing its scripts or shell placeholders.&lt;/p&gt;

&lt;p&gt;Compatibility findings come from capability profiles with source references. When a profile doesn’t have verified evidence for a behavior, the tool reports the uncertainty.&lt;/p&gt;

&lt;p&gt;The report is a starting point for review. It doesn’t guarantee identical model behavior.&lt;/p&gt;

&lt;h2&gt;
  
  
  What I’ve checked so far
&lt;/h2&gt;

&lt;p&gt;In a small compatibility check &lt;a href="https://github.com/Stevesadr/skillporter#compatibility-check" rel="noopener noreferrer"&gt;documented in the repository&lt;/a&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Eight installs succeeded and were discovered by their target agents.&lt;/li&gt;
&lt;li&gt;All 196 copied files matched their sources byte for byte.&lt;/li&gt;
&lt;li&gt;Three conversions still reported losses.&lt;/li&gt;
&lt;li&gt;All eight conversions produced lint warnings.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Those results illustrate why file preservation and behavioral compatibility need separate checks.&lt;/p&gt;

&lt;p&gt;The README also includes a small before-and-after comparison of three skills run in OpenCode and Codex. The tested behavior carried over in those cases, but one run per task and agent is limited evidence.&lt;/p&gt;

&lt;h2&gt;
  
  
  Where the alpha needs feedback
&lt;/h2&gt;

&lt;p&gt;Skillporter &lt;code&gt;0.1.0&lt;/code&gt; is an experimental public alpha. Commands, report formats, and lint rule IDs may change before &lt;code&gt;1.0&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Host-specific hooks and agent-specific script dependencies still need human attention. A script that calls its original agent’s CLI won’t become portable simply because its directory was converted.&lt;/p&gt;

&lt;p&gt;The feedback I’d find most useful is &lt;strong&gt;one real migration where the report misses something or gets a capability wrong&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;If you try it, please include the source and destination agent versions, the Skillporter version, and the exact command. A minimal skill that reproduces the issue is especially helpful.&lt;/p&gt;

&lt;p&gt;You can find the code, compatibility notes, and examples on &lt;strong&gt;&lt;a href="https://github.com/Stevesadr/skillporter" rel="noopener noreferrer"&gt;GitHub&lt;/a&gt;&lt;/strong&gt;, or report a reproducible incompatibility in &lt;strong&gt;&lt;a href="https://github.com/Stevesadr/skillporter/issues" rel="noopener noreferrer"&gt;Issues&lt;/a&gt;&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;What has broken when you’ve moved a skill between coding agents?&lt;/p&gt;

</description>
      <category>ai</category>
      <category>opensource</category>
      <category>cli</category>
      <category>devtools</category>
    </item>
  </channel>
</rss>
