[caelaxie]

Closes #10

Can an agent invoke /create-skill the way upstream invokes Cursor's create-skill skill, and does it have a YAML-rules / writing-guidelines / description-optimization surface?

No. Factory's skills docs describe /create-skill as a user slash command. In the CLI it opens a Create Skill pane; in the Factory App it opens a wizard. It forks the session into Spec mode, researches the workflow, and writes files only after the user approves. It is not a skill an agent or subagent can hand work to, and the docs do not describe a YAML-rules, writing-guidelines, draft/test/iterate, or description-optimization surface.

Callers therefore stay pointed at the authoring playbook and at Droid's real frontmatter rules (description is one YAML scalar). This PR only drops the citations of loops and named sections the playbook does not contain:

• automate-me no longer says the playbook has "YAML rules" or "writing guidelines". The scalar rules stay. Prose edits point at the playbook's prose rules.
• reflect no longer says to run a draft/test/iterate loop or a description-optimization loop.

Left as they are, because they name something that exists:

• the playbook's step 1 (frontmatter name and description, lowercase-hyphen directory name, supporting files beside SKILL.md)
• poteto-mode's pointer at that playbook for agent-facing prose
• new skill: in reflect and the synthesizer, rather than new skill via create-skill:
• docs/guide/09-make-it-yours.md, which already routes through the playbook and its frontmatter check

  

[caelaxie]

verdict: pass, merging.

• minimum changes: 4/4 lines, takes #10's fallback branch. the factory docs answer (/create-skill is a user slash command with a spec-mode pane, no agent-callable yaml/writing/loop surface) is stated in the body, so dropping the playbook "YAML rules", "writing guidelines", draft/test/iterate and description-optimization citations is the right cut. nothing else touched.
• layout/target: no cursor paths or shims added.
• parity: unchanged otherwise; the true references (playbook step 1, poteto-mode pointer, new skill:, 09-make-it-yours) stay.
• proof: Validate plugin green on 409fdb0. droid ci does marketplace add pstack-ports/droid-pstack#<branch> + plugin install + plugin list + skill frontmatter checks, accepted for a text-only skill fix (agy #30 precedent).
• linkage: Closes #10. not a draft.

[cursor]

Harness proof. Command output is unedited.

HOME=/tmp/droid-proof-create-skill
which=/tmp/droid-proof-create-skill/.local/bin/droid
0.245.0
===== droid plugin marketplace add =====
Successfully added marketplace: droid-pstack@cursor-create-skill-true-references-9106
===== droid plugin install =====
Successfully installed pstack@droid-pstack@cursor-create-skill-true-references-9106 (409fdb0)
===== droid plugin list =====
Installed plugins:
Active:
  pstack@droid-pstack@cursor-create-skill-true-references-9106  [user]  409fdb0
$ git -C /tmp/droid-proof-create-skill/.factory/plugins/cache/droid-pstack@cursor-create-skill-true-references-9106-4853f9ebdca3/pstack-7171b73fae68/409fdb0b651f rev-parse HEAD
409fdb0b651ff4d992a23156d29e5883c4ca69a9
(exit 0)
$ echo expected
409fdb0b651ff4d992a23156d29e5883c4ca69a9
$ git -C /workspace diff --name-status 3a60c3580a01bba100804e6efe3395d9f5dd924e cursor/create-skill-true-references-9106
M	skills/automate-me/SKILL.md
M	skills/reflect/SKILL.md
(exit 0)
MATCH skills/automate-me/SKILL.md
MATCH skills/reflect/SKILL.md
===== droid exec =====
Skill "automate-me" activated
Error during droid execution: Authentication failed. Please log in using /login or set a valid FACTORY_API_KEY environment variable.