{"id":"900e0ebe-80ef-47e3-bf87-c4b7845da4fd","shortId":"DSHDpZ","kind":"skill","title":"alignfirst","tagline":"Collaborative problem-solving protocols. Write technical specifications (spec, or alspec), create implementation plans (plan, or alplan), or use Align-and-Do Protocol (AAD). Also generates PR/MR descriptions (aldescription) and code review reports (alreview).","description":"# AlignFirst Guide\n\nIf you don't already know which protocol to use, read [overview.md](references/overview.md) first.\n\n## Protocols\n\n- **Technical Specification** (_spec_, or _alspec_): [spec-protocol.md](references/spec-protocol.md)\n- **Implementation Plans** (_plan_, or _alplan_): [plan-protocol.md](references/plan-protocol.md)\n- **Align-and-Do Protocol** (_AAD_): [aad-protocol.md](references/aad-protocol.md)\n- **Description** (_aldescription_): [description-protocol.md](references/description-protocol.md)\n- **Code Review** (_alreview_): [review-protocol.md](references/review-protocol.md)\n\n## TASK_DIR Location\n\n**TASK_DIR** is the directory where work files related to a task are stored. Usually, we use **TASK_DIR** = `.plans/{TICKET_ID}/` (a sub-directory of the `.plans` folder). If no ticket ID is known, ask the user for it.\n\n- Create TASK_DIR if it doesn't exist\n- Or, list all existing files (do not truncate)\n\n## File Naming Convention\n\nFormat: `{CYCLE_LETTER}{FILE_NUMBER}-{FILE_TYPE}.md`\n\n**Common file types:**\n\n- `spec` - technical specification\n- `plan` - implementation plan\n- `AAD.summary` - AAD summary document\n- `description` - PR/MR description\n- `review` - code review report\n\n**Example structure:**\n\n```text\n.plans/\n├── 123/\n│   ├── A1-spec.md\n│   ├── A2-plan.md\n│   └── A3-AAD.summary.md\n│   └── B1-spec.md\n```\n\n## Notes\n\n- **TICKET_ID** is a unique identifier for the task, often an issue or ticket number.\n- Cycles are identified by a **CYCLE_LETTER** (A, B, C...).\n- The protocol or the user decides whether the next file continues the current cycle or starts a new one.\n- To determine the next filename in the current cycle: find the highest CYCLE_LETTER, then the highest FILE_NUMBER within it. Bump the number.\n- For a new cycle: bump CYCLE_LETTER and reset FILE_NUMBER to 1.\n- Do not bother the user with CYCLE_LETTER or FILE_NUMBER. They are for internal organization. Start CYCLE_LETTER with `A` if there is no existing cycle. So you just need to ask for a **ticket ID** if you don't have one.\n- There is no strict sequence of file types in the workflow. Available file types are also flexible; if you need a new one, just create it.","tags":["alignfirst","paleo","agent-skills","agentic-coding","agentic-engineering"],"capabilities":["skill","source-paleo","skill-alignfirst","topic-agent-skills","topic-agentic-coding","topic-agentic-engineering"],"categories":["alignfirst"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/paleo/alignfirst/alignfirst","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add paleo/alignfirst","source_repo":"https://github.com/paleo/alignfirst","install_from":"skills.sh"}},"qualityScore":"0.489","qualityRationale":"deterministic score 0.49 from registry signals: · indexed on github topic:agent-skills · 78 github stars · SKILL.md body (2,175 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T12:55:22.823Z","embedding":null,"createdAt":"2026-04-18T22:12:35.753Z","updatedAt":"2026-05-02T12:55:22.823Z","lastSeenAt":"2026-05-02T12:55:22.823Z","tsv":"'1':266 '123':180 'a1-spec.md':181 'a2-plan.md':182 'a3-aad.summary.md':183 'aad':26,73,166 'aad-protocol.md':74 'aad.summary':165 'aldescript':31,77 'align':22,69 'align-and-do':21,68 'alignfirst':1,37 'alplan':18,65 'alreadi':43 'alreview':36,82 'also':27,325 'alspec':12,58 'ask':124,299 'avail':321 'b':209 'b1-spec.md':184 'bother':269 'bump':251,258 'c':210 'code':33,80,173 'collabor':2 'common':156 'continu':221 'convent':147 'creat':13,129,334 'current':223,237 'cycl':149,201,206,224,238,242,257,259,273,284,293 'decid':216 'descript':30,76,169,171 'description-protocol.md':78 'determin':231 'dir':86,89,106,131 'directori':92,113 'document':168 'doesn':134 'exampl':176 'exist':136,140,292 'file':95,141,145,151,153,157,220,247,263,276,316,322 'filenam':234 'find':239 'first':52 'flexibl':326 'folder':117 'format':148 'generat':28 'guid':38 'highest':241,246 'id':109,121,187,303 'identifi':191,203 'implement':14,61,163 'intern':281 'issu':197 'know':44 'known':123 'letter':150,207,243,260,274,285 'list':138 'locat':87 'md':155 'name':146 'need':297,329 'new':228,256,331 'next':219,233 'note':185 'number':152,200,248,253,264,277 'often':195 'one':229,309,332 'organ':282 'overview.md':50 'plan':15,16,62,63,107,116,162,164,179 'plan-protocol.md':66 'pr/mr':29,170 'problem':4 'problem-solv':3 'protocol':6,25,46,53,72,212 'read':49 'references/aad-protocol.md':75 'references/description-protocol.md':79 'references/overview.md':51 'references/plan-protocol.md':67 'references/review-protocol.md':84 'references/spec-protocol.md':60 'relat':96 'report':35,175 'reset':262 'review':34,81,172,174 'review-protocol.md':83 'sequenc':314 'skill' 'skill-alignfirst' 'solv':5 'source-paleo' 'spec':10,56,159 'spec-protocol.md':59 'specif':9,55,161 'start':226,283 'store':101 'strict':313 'structur':177 'sub':112 'sub-directori':111 'summari':167 'task':85,88,99,105,130,194 'technic':8,54,160 'text':178 'ticket':108,120,186,199,302 'topic-agent-skills' 'topic-agentic-coding' 'topic-agentic-engineering' 'truncat':144 'type':154,158,317,323 'uniqu':190 'use':20,48,104 'user':126,215,271 'usual':102 'whether':217 'within':249 'work':94 'workflow':320 'write':7","prices":[{"id":"aa1105fa-a617-4f12-af26-85372e00aa93","listingId":"900e0ebe-80ef-47e3-bf87-c4b7845da4fd","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"paleo","category":"alignfirst","install_from":"skills.sh"},"createdAt":"2026-04-18T22:12:35.753Z"}],"sources":[{"listingId":"900e0ebe-80ef-47e3-bf87-c4b7845da4fd","source":"github","sourceId":"paleo/alignfirst/alignfirst","sourceUrl":"https://github.com/paleo/alignfirst/tree/main/skills/alignfirst","isPrimary":false,"firstSeenAt":"2026-04-18T22:12:35.753Z","lastSeenAt":"2026-05-02T12:55:22.823Z"}],"details":{"listingId":"900e0ebe-80ef-47e3-bf87-c4b7845da4fd","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"paleo","slug":"alignfirst","github":{"repo":"paleo/alignfirst","stars":78,"topics":["agent-skills","agentic-coding","agentic-engineering"],"license":"cc0-1.0","html_url":"https://github.com/paleo/alignfirst","pushed_at":"2026-04-23T15:48:56Z","description":"The skill of Spartan developers who love well-written code","skill_md_sha":"c2a764dbad0c3a0f858facffcb0de1dd86852ef6","skill_md_path":"skills/alignfirst/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/paleo/alignfirst/tree/main/skills/alignfirst"},"layout":"multi","source":"github","category":"alignfirst","frontmatter":{"name":"alignfirst","license":"CC0 1.0","description":"Collaborative problem-solving protocols. Write technical specifications (spec, or alspec), create implementation plans (plan, or alplan), or use Align-and-Do Protocol (AAD). Also generates PR/MR descriptions (aldescription) and code review reports (alreview)."},"skills_sh_url":"https://skills.sh/paleo/alignfirst/alignfirst"},"updatedAt":"2026-05-02T12:55:22.823Z"}}