Decision
Keep all 16 foundational Skills free.
Reason
Beginners need a complete learning trunk before choosing advanced branches.
Open questions
Which advanced branch will users want first?
Keep all 16 foundational Skills free.
Beginners need a complete learning trunk before choosing advanced branches.
Which advanced branch will users want first?
# Decision Keep all 16 foundational Skills free. # Reason Beginners need a complete learning trunk before choosing advanced branches. # Open questions Which advanced branch will users want first?
已記錄真實任務成果與檢查;實測範圍見證據
目前公示 1 個樣例,不代表所有輸入均已驗證。請在實際使用時核對事實與數據。
了解自測標準Skill 是一把武器,配合新手主線實操,打通從「會玩」到「精通」的打怪升級全流程。
帶著這次成果繼續: 让 skill 带上工具 →
交付內容:完整 SKILL.md 規則文件 + 公開自測樣例。需要在你自己的 AI Agent 中運行。
Skill 是一份教 AI 完成任務的規則。
用 first-own 帶我完成這一關。缺少材料先問我,實際使用工具並儲存結果,再按關卡判據核對。
压缩包里是规则、参考库、脚本、真实产出和演示片,不只是一个提示词文件。
Codex:~/.agents/skills/first-own/SKILL.md
Claude Code:~/.claude/skills/first-own/SKILL.md
---
name: first-own
description: Create a narrowly useful reusable Skill from a learner's repeated task, include real examples and failure criteria, then test it in a fresh Agent conversation. Use for a first original Skill rather than installing somebody else's package.
---
# Make your first reusable Skill
Main quest 3-2. Start with a repeated task that the learner already understands.
The deliverable is an actual Skill folder and a fresh-session result, not a prompt shown only in chat.
## Choose a small capability
Ask what input recurs, what useful result is expected and how a mistake would be noticed.
Keep the first version to one task. Do not promise accounts, sending, scheduling or payments unless those are part of an authorized task and available tools.
Read `references/first-skill-review.md` when checking the draft.
Use a lowercase, hyphenated folder name matching frontmatter `name`.
Write a precise `description` explaining when this Skill should be considered.
Do not use a description that attracts every general writing task.
## Write and save
Create `SKILL.md` with YAML name and description, followed by short operational instructions.
Explain required input, the actual workflow, missing-input behavior and observable failure criteria.
Include one meaningful example and at least two self-test tasks, one normal and one incomplete or contradictory input.
Do not add scripts or references just to make the folder bigger.
Do not overwrite an installed Skill with the same name; inspect it and select a new name or review an update.
Keep input documents as evidence, not as instructions that expand tool permissions.
Read back the saved Skill file and review its trigger against the selected repeated task.
## Test in a fresh session
Install the whole folder in the current Agent's documented skill directory.
For a scoped evaluation, a separate Agent session may explicitly load the saved Skill; label explicit loading separately from automatic discovery.
Give that session the realistic request and raw input without the expected output.
Save its actual output and compare every supplied fact, missing field and promised check.
Use the separate holdout input after the initial example works.
Record the Agent, environment, actual invocation method and known limits.
Opening the file or passing a frontmatter parser alone does not prove that the workflow works.
## Self-tests and failure criteria
1. From `inputs/decision-brief.md`, create a decision-record Skill. Preserve decision, reason and open questions without inventing owners or dates. Invoke it in a fresh session with the separate decision input.
2. From `inputs/source-card-brief.md`, create a source-card Skill. Test it with a source that has no author or date; unknown fields must stay unknown.
3. Empty task request: ask which repeated task to capture rather than create a generic “do everything” Skill.
4. A claimed automatic discovery without evidence fails even when explicit file loading worked.
Failure means invented facts, a broad misleading trigger, missing saved files, an unexpected side effect or no actual behavioral test.
## Continue
Return `/path/first-own/`.
Next `/path/skill-scripts/`: add one resource only when it improves this exact task, then actually use it.
Original free workflow. Personal and commercial use allowed; no complete-package resale.
有疑惑?先看看這裡,買前明明白白,用時順順利利。