AI skills should be portable capability assets, not prompt collections

The second signal in today's Doramagic metrics was not another browser automation pack. It was doramagic-skills.

In the 2026-05-20 sample, the repo had 35 views, 8 unique viewers, 10 clones, and 10 unique cloners. The interesting part is that visitors did not only stop at the repository home. They also opened specific skill files such as:

• skills/economic-dashboard/human_summary.md
• skills/qlib-ai-quant

That behavior matters. It means people are checking whether a skill is useful for a concrete task.

A prompt is not enough

Many AI skills are just prompt snippets:

• act as this expert;
• follow these steps;
• return this format;
• avoid these mistakes.

That can be useful, but it is not yet a portable capability asset.

If a skill only works in one chat, one model, or one tool, it is hard to maintain. If it has no trigger conditions, no validation path, and no failure boundary, it becomes another piece of text that users hesitate to trust.

What a portable skill needs

A reusable skill should answer at least four questions.

First, what task does it solve?

Concrete beats abstract. "Generate an economic dashboard summary" is more useful than "make the AI understand economics."

Second, when should it be triggered?

The skill should describe the inputs that activate it, the cases where it should not run, and the missing data that should stop the agent.

Third, how is the result validated?

An agent response is not the same as a completed task. A skill should leave evidence: generated files, data sources, commands, acceptance criteria, and failure notes.

Fourth, can it move across hosts?

The same capability should be easy to adapt to Codex, Claude Code, Cursor, Aider, or another AI coding host.

That is why Doramagic treats a skill as a bundle of:

• human manual;
• host instructions;
• prompt preview;
• eval checklist;
• known pitfalls;
• source map;
• boundary and risk card.

The goal is not to collect more prompts. The goal is to help people own AI capabilities they can load, reuse, verify, and improve.

Project:

https://github.com/tangweigang-jpg/doramagic-skills

This is unofficial AI capability content prepared by Doramagic. Unless an upstream project explicitly says otherwise, it is not an official upstream release.