{"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- **Merge** (_merge_, or _almerge_): [merge-protocol.md](references/merge-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- `merge.summary` - merge conflicts resolution summary\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 · 79 github stars · SKILL.md body (2,317 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-18T18:56:45.941Z","embedding":null,"createdAt":"2026-04-18T22:12:35.753Z","updatedAt":"2026-05-18T18:56:45.941Z","lastSeenAt":"2026-05-18T18:56:45.941Z","tsv":"'1':277 '123':191 'a1-spec.md':192 'a2-plan.md':193 'a3-aad.summary.md':194 'aad':26,73,172 'aad-protocol.md':74 'aad.summary':171 'aldescript':31,77 'align':22,69 'align-and-do':21,68 'alignfirst':1,37 'almerg':88 'alplan':18,65 'alreadi':43 'alreview':36,82 'also':27,336 'alspec':12,58 'ask':130,310 'avail':332 'b':220 'b1-spec.md':195 'bother':280 'bump':262,269 'c':221 'code':33,80,179 'collabor':2 'common':162 'conflict':184 'continu':232 'convent':153 'creat':13,135,345 'current':234,248 'cycl':155,212,217,235,249,253,268,270,284,295,304 'decid':227 'descript':30,76,175,177 'description-protocol.md':78 'determin':242 'dir':92,95,112,137 'directori':98,119 'document':174 'doesn':140 'exampl':187 'exist':142,146,303 'file':101,147,151,157,159,163,231,258,274,287,327,333 'filenam':245 'find':250 'first':52 'flexibl':337 'folder':123 'format':154 'generat':28 'guid':38 'highest':252,257 'id':115,127,198,314 'identifi':202,214 'implement':14,61,169 'intern':292 'issu':208 'know':44 'known':129 'letter':156,218,254,271,285,296 'list':144 'locat':93 'md':161 'merg':85,86,183 'merge-protocol.md':89 'merge.summary':182 'name':152 'need':308,340 'new':239,267,342 'next':230,244 'note':196 'number':158,211,259,264,275,288 'often':206 'one':240,320,343 'organ':293 'overview.md':50 'plan':15,16,62,63,113,122,168,170,190 'plan-protocol.md':66 'pr/mr':29,176 'problem':4 'problem-solv':3 'protocol':6,25,46,53,72,223 'read':49 'references/aad-protocol.md':75 'references/description-protocol.md':79 'references/merge-protocol.md':90 'references/overview.md':51 'references/plan-protocol.md':67 'references/review-protocol.md':84 'references/spec-protocol.md':60 'relat':102 'report':35,181 'reset':273 'resolut':185 'review':34,81,178,180 'review-protocol.md':83 'sequenc':325 'skill' 'skill-alignfirst' 'solv':5 'source-paleo' 'spec':10,56,165 'spec-protocol.md':59 'specif':9,55,167 'start':237,294 'store':107 'strict':324 'structur':188 'sub':118 'sub-directori':117 'summari':173,186 'task':91,94,105,111,136,205 'technic':8,54,166 'text':189 'ticket':114,126,197,210,313 'topic-agent-skills' 'topic-agentic-coding' 'topic-agentic-engineering' 'truncat':150 'type':160,164,328,334 'uniqu':201 'use':20,48,110 'user':132,226,282 'usual':108 'whether':228 'within':260 'work':100 'workflow':331 '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-18T18:56:45.941Z"},{"listingId":"900e0ebe-80ef-47e3-bf87-c4b7845da4fd","source":"skills_sh","sourceId":"paleo/alignfirst/alignfirst","sourceUrl":"https://skills.sh/paleo/alignfirst/alignfirst","isPrimary":true,"firstSeenAt":"2026-05-07T20:45:41.250Z","lastSeenAt":"2026-05-07T22:43:32.427Z"}],"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":79,"topics":["agent-skills","agentic-coding","agentic-engineering"],"license":"cc0-1.0","html_url":"https://github.com/paleo/alignfirst","pushed_at":"2026-05-17T16:54:16Z","description":"The skill of Spartan developers who love well-written code","skill_md_sha":"7b64274bbcd662dd9ae805779203302299ebad9a","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-18T18:56:45.941Z"}}