==================================================================================================== MATT POCOCK AGENT SKILLS GUIDE (සිංහල සහ ඉංග්‍රීසි සම්පූර්ණ අත්පොත) ==================================================================================================== මූලාශ්‍රය (Source): https://github.com/mattpocock/skills ස්ථාපිත ස්ථානය (Installed Location): - Workspace: c:\em\Main Project\skillls\.agents\skills\ - Global: C:\Users\Dell\.gemini\config\skills\ එකතුව (Total Skills): 38 Skills ---------------------------------------------------------------------------------------------------- භාවිතා කරන ආකාරය (HOW TO USE) ---------------------------------------------------------------------------------------------------- 1. ස්වයංක්‍රීයව (Automatic / On-Demand): ඔබ agent සමඟ කතා කරන විට ඔබගේ අවශ්‍යතාවය අනුව (උදා: "review this code", "find this bug") agent විසින් අදාළ skill එක ස්වයංක්‍රීයව හඳුනාගෙන ක්‍රියාත්මක කරනු ලබයි. 2. සෘජු විධානයක් ලෙස (Slash Command): ඔබට අවශ්‍ය නම් කෙළින්ම slash command එකක් ලෙස ටයිප් කළ හැක. උදාහරණ: /grill-me, /code-review, /tdd, /setup-matt-pocock-skills ==================================================================================================== 1. මෘදුකාංග ඉංජිනේරු විද්‍යාව (ENGINEERING SKILLS - 20 SKILLS) ==================================================================================================== [01] /ask-matt ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Ask which skill or flow fits your situation. Acts as an intelligent router over the skills. - සිංහල තේරුම (Sinhala): ඔබගේ කාර්යයට වඩාත්ම ගැළපෙන skill එක හෝ වැඩපිළිවෙළ තෝරා ගැනීමට මඟපෙන්වන උපදේශකයා (Router). - භාවිතා කරන අවස්ථාව (When to use): "මට මේ feature එක හදන්න ඕන, මම පාවිච්චි කරන්න ඕන හොඳම skill එක මොකක්ද?" කියා අසන විට. [02] /code-review ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Review git changes since a fixed point (commit, branch, PR) along two axes: Standards & Spec. Runs parallel sub-agents to avoid context pollution. - සිංහල තේරුම (Sinhala): කේත සමාලෝචනය (Code Review). ඔබ ලියූ කේතය ආයතනයේ/ව්‍යාපෘතියේ නීති (Standards) වලට එකඟද සහ මුල් අවශ්‍යතාවයට (Spec) නිවැරදිව ගැළපේදැයි sub-agents දෙදෙනෙකු මඟින් පරීක්ෂා කර සම්පූර්ණ වාර්තාවක් ලබා දේ. - භාවිතා කරන අවස්ථාව (When to use): PR එකක් දැමීමට පෙර හෝ වෙනස්කම් පරීක්ෂා කිරීමට (උදා: "review my changes against main"). [03] /codebase-design ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Shared vocabulary and architecture principles for designing deep modules, clear seams, and testable interfaces. - සිංහල තේරුම (Sinhala): කේත පදනමේ නිර්මාණ ශිල්පය (Deep Module Design). Codebase එක පිරිසිදුව, ගැඹුරු මොඩියුල (deep modules) සහ සරල interfaces සහිතව, පහසුවෙන් test කළ හැකි අයුරින් සැලසුම් කිරීමට මඟපෙන්වයි. - භාවිතා කරන අවස්ථාව (When to use): නව module එකක් නිර්මාණය කිරීමේදී හෝ පවතින architecture එකක් refactor කිරීමේදී. [04] /diagnosing-bugs ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Systematic diagnosis loop for hard bugs, crashes, and performance regressions. - සිංහල තේරුම (Sinhala): සංකීර්ණ දෝෂ (Hard Bugs) සහ ක්‍රියාකාරීත්ව ගැටලු (Slowdowns/Crashes) ක්‍රමානුකූලව විනිශ්චය කිරීම. අනුමාන කිරීම් වලින් තොරව, නිවැරදි සාක්ෂි මත පදනම්ව මූලික හේතුව (Root Cause) සොයා ගනී. - භාවිතා කරන අවස්ථාව (When to use): කේතයේ හඳුනාගත නොහැකි bug එකක් ආ විට (උදා: "diagnose why this API is failing"). [05] /domain-modeling ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Build and sharpen a project's domain model, ubiquitous language, GLOSSARY.md, and ADRs. - සිංහල තේරුම (Sinhala): ව්‍යාපෘතියේ වසම් ආකෘතිය (Domain Model). කේතය තුළ භාවිත වන වචන මාලාව (ubiquitous language), ශබ්දකෝෂය (GLOSSARY.md) සහ වාස්තු විද්‍යාත්මක තීරණ (ADRs) නිවැරදිව සටහන් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): Project එකේ නියමිත පාරිභාෂික වචන සහ domain rules ලේඛනගත කිරීමට. [06] /grill-with-docs ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): A relentless interview to sharpen a plan or design, which also creates docs (ADRs and glossary) as you go. - සිංහල තේරුම (Sinhala): සැලසුමක් ගැන සවිස්තරාත්මකව ප්‍රශ්න කර (Grill), ඒ සමඟම අවශ්‍ය ලියකියවිලි (ADR, Glossary) ස්වයංක්‍රීයව නිර්මාණය කරමින් සැලසුම පරිපූර්ණ කිරීම. - භාවිතා කරන අවස්ථාව (When to use): විශාල වෙනසක් කිරීමට පෙර සියලු පැති ආවරණය වන පරිදි තීරණ ගැනීමට. [07] /implement ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Implement a piece of work based on an approved spec or set of tickets. - සිංහල තේරුම (Sinhala): අනුමත කරන ලද spec එකක් හෝ tickets පදනම් කරගෙන සැබෑ කේතනය (Coding) සිදු කිරීම. - භාවිතා කරන අවස්ථාව (When to use): සැලසුම් සකස් කර අවසන් වූ පසු කේතය ලිවීම ආරම්භ කිරීමට. [08] /implement-spec ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Implement the exact result of /to-spec and /to-tickets in code. - සිංහල තේරුම (Sinhala): `/to-spec` සහ `/to-tickets` මඟින් සකස් කරන ලද නිශ්චිත සැලසුම කේතයක් බවට පත් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): Spec එකක ඇති සෑම පියවරක්ම ඒ ආකාරයෙන්ම code එකට නැගීමට. [09] /improve-codebase-architecture ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Scan a codebase for deepening opportunities, present a visual HTML report, and grill through chosen areas. - සිංහල තේරුම (Sinhala): Codebase එක පරිලෝකනය කර එහි ව්‍යුහය දියුණු කළ හැකි තැන් හඳුනාගෙන, visual HTML වාර්තාවක් ලබා දීම. - භාවිතා කරන අවස්ථාව (When to use): පැරණි හෝ අවුල් සහගත codebase එකක ගුණාත්මකභාවය ඉහළ නැංවීමට. [10] /pr ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Generate an exemplary, structured Pull Request (PR) body and summary. - සිංහල තේරුම (Sinhala): Pull Request (PR) එකක් සඳහා ඉතා පැහැදිලි, කියවීමට පහසු සහ සම්පූර්ණ විස්තරයක් (PR Description) ලිවීම. - භාවිතා කරන අවස්ථාව (When to use): GitHub හෝ GitLab වෙත PR එකක් submit කිරීමට පෙර. [11] /prototype ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Build a throwaway prototype to test state logic, UI design, or architectural ideas quickly. - සිංහල තේරුම (Sinhala): අත්හදා බැලීමේ ආකෘතියක් (Throwaway Prototype) සෑදීම. යම් අදහසක් හෝ UI එකක් නිවැරදිදැයි කඩිනමින් බලා ගැනීමට. - භාවිතා කරන අවස්ථාව (When to use): සම්පූර්ණ කේතය ලියන්නට පෙර අදහස ප්‍රායෝගිකව ක්‍රියාත්මක වේදැයි බැලීමට. [12] /research ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Investigate a technical question against high-trust primary sources and save findings as Markdown. - සිංහල තේරුම (Sinhala): නිල ලියකියවිලි (Official Docs) සහ විශ්වාසනීය මූලාශ්‍ර පරිශීලනය කර තාක්ෂණික පර්යේෂණයක් සිදු කර වාර්තාවක් ලිවීම. - භාවිතා කරන අවස්ථාව (When to use): නොදන්නා API එකක්, library එකක් හෝ තාක්ෂණයක් ගැන නිවැරදි තොරතුරු සෙවීමට. [13] /retro ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Conduct a retrospective on a coding session to capture learnings and process improvements. - සිංහල තේරුම (Sinhala): පසු විපරම (Retrospective). Coding session එකක් අවසානයේ සාර්ථක වූ කරුණු සහ මීළඟට දියුණු විය යුතු කරුණු විමසා බැලීම. - භාවිතා කරන අවස්ථාව (When to use): වැඩ කොටසක් නිම වූ විට team එකට හෝ තමන්ටම review එකක් ගැනීමට. [14] /setup-matt-pocock-skills ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Configure repository for engineering skills (issue tracker, triage labels, domain doc layout). Run once. - සිංහල තේරුම (Sinhala): ව්‍යාපෘතිය මෙම skills සඳහා මූලිකව සැකසීම. Issue tracker (GitHub/GitLab/Local) සහ ලේඛන ගබඩා කරන තැන් configure කරයි. - භාවිතා කරන අවස්ථාව (When to use): නව repo එකකදී එක් වරක් run කර settings හදා ගැනීමට. [15] /tdd ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Test-Driven Development (Red-Green-Refactor) workflow for writing rock-solid features and tests first. - සිංහල තේරුම (Sinhala): පරීක්ෂණ මඟින් මෙහෙයවන සංවර්ධනය (TDD). පළමුව test ලියා (Red), පසුව එය pass වන කේතය ලියා (Green), අවසානයේ කේතය පිරිසිදු කිරීම (Refactor). - භාවිතා කරන අවස්ථාව (When to use): Bugs රහිත උසස් තත්ත්වයේ කේත ලිවීමට (උදා: "build this auth feature with tdd"). [16] /to-spec ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Synthesize current conversation into a formal, structured specification document. - සිංහල තේරුම (Sinhala): දැනට කරන ලද සංවාදයේ කරුණු කැටි කර, ක්‍රමානුකූල Specification (Spec) ලේඛනයක් බවට පත් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): කතාබහ කරගත් කරුණු අමතක නොවී පැහැදිලි spec එකක් ලෙස සටහන් කරගැනීමට. [17] /to-tickets ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Break a plan or spec into a set of dependency-linked, actionable tickets. - සිංහල තේරුම (Sinhala): සැලසුමක් හෝ spec එකක් එකිනෙකට බැඳුණු කුඩා tickets / tasks බවට කඩා පෙළගැස්වීම. - භාවිතා කරන අවස්ථාව (When to use): Project එකක tasks ලැයිස්තුවක් සාදා ගැනීමට (උදා: GitHub issues / Jira tickets). [18] /triage ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Move issues and external PRs through a state machine of triage roles, categorize, verify, and brief. - සිංහල තේරුම (Sinhala): Issues සහ PRs වර්ගීකරණය කිරීම (Triage). දෝෂ තහවුරු කර, ප්‍රමුඛතාවය දී, විසඳීමට පහසු වන සේ සකස් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): GitHub issues විශාල සංඛ්‍යාවක් එකතු වී ඇති විට ඒවා පිළිවෙළක් කිරීමට. [19] /wayfinder ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Plan a massive initiative as a map of decision tickets and resolve them sequentially. - සිංහල තේරුම (Sinhala): තනි වරකින් කළ නොහැකි අතිවිශාල ව්‍යාපෘතියක්, තීරණ සිතියමක් (decision map) ලෙස පෙළගස්වා පියවරෙන් පියවර විසඳීම. - භාවිතා කරන අවස්ථාව (When to use): සති හෝ මාස ගණනක් ගතවන විශාල software system එකක් සැලසුම් කිරීමට. [20] /wizard ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Generate an interactive bash wizard walking a human through manual-only steps (keys, cloud dashboards). - සිංහල තේරුම (Sinhala): මිනිසෙකු විසින්ම කළ යුතු දේවල් (උදා: Cloud console, secrets, credentials) සඳහා interactive මඟපෙන්වීමේ script එකක් සෑදීම. - භාවිතා කරන අවස්ථාව (When to use): Agent ට තනිව කළ නොහැකි dashboard settings හෝ credentials configure කරන විට. ==================================================================================================== 2. ඵලදායිතාව සහ සිතීමේ හැකියාව (PRODUCTIVITY & THINKING - 7 SKILLS) ==================================================================================================== [21] /grill-me ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): A relentless interview to sharpen any plan, decision, or idea through rigorous questioning. - සිංහල තේරුම (Sinhala): ඔබගේ සැලසුම හෝ අදහස ගැන agent විසින් ගැඹුරින් ප්‍රශ්න අසා (Grill), එහි ඇති අඩුපාඩු පෙන්වා දී එය ශක්තිමත් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): ඕනෑම අලුත් feature එකක් හෝ business තීරණයක් ක්‍රියාත්මක කිරීමට පෙර. [22] /grilling ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Stress-test thinking ruthlessly about an idea or architecture. - සිංහල තේරුම (Sinhala): අදහසක් හෝ architecture එකක් දැඩි පරීක්ෂාවකට (Stress-test) ලක් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): "Grill me on my database schema" වැනි විධානයන් දෙන විට. [23] /handoff ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Compact current conversation into a comprehensive handoff doc for another agent/session to continue. - සිංහල තේරුම (Sinhala): දැනට කළ වැඩ කොටස වෙනත් session එකකට හෝ agent කෙනෙකුට බාධාවකින් තොරව ඉදිරියට කරගෙන යාම සඳහා සාරාංශයක් සෑදීම. - භාවිතා කරන අවස්ථාව (When to use): Session එකක් අවසන් කිරීමට පෙර හෝ token ප්‍රමාණය වැඩි වන විට. [24] /teach ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Teach the user a new programming skill or concept within this workspace. - සිංහල තේරුම (Sinhala): ඔබට නොතේරෙන නව තාක්ෂණික සංකල්පයක් හෝ ක්‍රමවේදයක් උදාහරණ සහිතව උගන්වා දීම. - භාවිතා කරන අවස්ථාව (When to use): "teach me how async/await works under the hood" වැනි දේ ඇසීමට. [25] /to-questionnaire ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Turn a decision you can't fully answer into a questionnaire for stakeholders/team to fill. - සිංහල තේරුම (Sinhala): අපැහැදිලි හෝ අන් අයගේ අදහස් අවශ්‍ය තීරණයක්, අදාළ පාර්ශ්වයන්ට පහසුවෙන් පිළිතුරු දිය හැකි ප්‍රශ්නාවලියක් බවට පත් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): Client කෙනෙකුගෙන් හෝ Team Lead ගෙන් තොරතුරු විමසීමට අවශ්‍ය විට. [26] /wait-what ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Stop! That last explanation didn't land: re-pitch it simply and clearly. - සිංහල තේරුම (Sinhala): නවතින්න! අවසන් පැහැදිලි කිරීම තේරුම් ගැනීමට අපහසු විය; එය වඩාත් සරලව සහ පැහැදිලිව නැවත ඉදිරිපත් කරන්න. - භාවිතා කරන අවස්ථාව (When to use): Agent දුන් පිළිතුරක් පැටලී ඇත්නම් හෝ සංකීර්ණ වැඩි නම්. [27] /writing-for-agents ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Best practices for writing documents, instructions, and rules for AI agents (SKILL.md, AGENTS.md). - සිංහල තේරුම (Sinhala): AI Agents ලාට පහසුවෙන් තේරුම් ගත හැකි අයුරින් rules, instructions සහ skill documentation ලිවීමේ මාර්ගෝපදේශය. - භාවිතා කරන අවස්ථාව (When to use): ඔබ විසින්ම අලුත් agent skill එකක් හෝ AGENTS.md එකක් සාදන විට. ==================================================================================================== 3. සාමාන්‍ය සහ උපයෝගීතා (GENERAL & UTILITIES - 11 SKILLS) ==================================================================================================== [28] /chief-of-staff ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Pursue a long-running goal in a single session by co-ordinating background subagents. - සිංහල තේරුම (Sinhala): ප්‍රධාන සම්බන්ධීකාරක. Background subagents කිහිපදෙනෙකු මෙහෙයවමින් දිගුකාලීන ඉලක්කයක් සම්පූර්ණ කර දීම. - භාවිතා කරන අවස්ථාව (When to use): පියවර ගණනාවක් ඇති සංකීර්ණ කාර්යයක් පසුබිමින් මෙහෙයවීමට. [29] /claude-handoff ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Hand current work to a fresh background agent that picks up work immediately. - සිංහල තේරුම (Sinhala): පවතින කාර්යය වහාම නව background agent කෙනෙකුට පවරා ඉදිරියට කරගෙන යාම. - භාවිතා කරන අවස්ථාව (When to use): පසුබිමෙන් තවත් agent කෙනෙකු ලවා කාර්යය කරවීමට. [30] /loop-me ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Grill the user about specs for workflows they want to build within this workspace. - සිංහල තේරුම (Sinhala): ඔබ සාදන්නට යන workflows සහ specs ගැන අඛණ්ඩව ප්‍රශ්න අසමින් ඒවා පරිපූර්ණ කිරීම. - භාවිතා කරන අවස්ථාව (When to use): Workspace එක තුළ workflow එකක් සැලසුම් කරන විට. [31] /setup-ts-deep-modules ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Wire dependency-cruiser into a TypeScript repo so each package is a clean, encapsulated deep module. - සිංහල තේරුම (Sinhala): TypeScript ව්‍යාපෘතියක් තුළ මොඩියුල අතර අනවශ්‍ය පැටලීම් වැළැක්වීමට dependency-cruiser සකස් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): TypeScript codebase එකක modular architecture එක ශක්තිමත් කිරීමට. [32] /writing-beats ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Assemble raw writing material into a structured sequence/journey of narrative beats. - සිංහල තේරුම (Sinhala): අමු අදහස් සහ තොරතුරු තර්කානුකූල කතාන්දරයක් හෝ ලිපියක් ලෙස අනුපිළිවෙළට පෙළගැස්වීම (Story Beats). - භාවිතා කරන අවස්ථාව (When to use): ලිපියක් හෝ documentation එකක structure එක හදන විට. [33] /writing-fragments ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Exploratory mining of raw thoughts and fragments with no strict structure yet. - සිංහල තේරුම (Sinhala): ලිවීමේ ආරම්භක පියවර. සිතට එන අදහස් සහ සිතුවිලි නිදහසේ එකතු කර ගැනීම (Brainstorming). - භාවිතා කරන අවස්ථාව (When to use): අලුත් ලිපියක් ආරම්භ කරන අවස්ථාවේදී. [34] /writing-shape ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Shape raw material and beats into a finished article, paragraph by paragraph. - සිංහල තේරුම (Sinhala): එකතු කරගත් අදහස් සහ beats පදනම් කරගෙන කියවීමට ප්‍රියජනක, සම්පූර්ණ ලිපියක් ලිවීම. - භාවිතා කරන අවස්ථාව (When to use): අවසන් ලිපිය හෝ blog post එක ලියන විට. [35] /git-guardrails-claude-code ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Hooks to block dangerous git commands (push, reset --hard, clean, branch -D) from accidental runs. - සිංහල තේරුම (Sinhala): Git ආරක්ෂණ වැටවල්. Agent විසින් වැරදීමකින් හෝ හානිකර git commands ක්‍රියාත්මක වීම වළක්වන hooks සැකසීම. - භාවිතා කරන අවස්ථාව (When to use): කේත ආරක්ෂාව සහ දත්ත අහිමි වීම වැළැක්වීමට. [36] /migrate-to-shoehorn ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Migrate test files from unsafe `as` type assertions to `@total-typescript/shoehorn`. - සිංහල තේරුම (Sinhala): TypeScript tests වල ඇති අවදානම් සහගත `as` type assertions ඉවත් කර Shoehorn ක්‍රමයට පරිවර්තනය කිරීම. - භාවිතා කරන අවස්ථාව (When to use): TypeScript test suite එකක type safety වැඩි කිරීමට. [37] /scaffold-exercises ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Create exercise directory structures with sections, problems, solutions, and explainers. - සිංහල තේරුම (Sinhala): අභ්‍යාස හෝ පාඨමාලා සඳහා ගැටලු, විසඳුම් සහ පැහැදිලි කිරීම් සහිත file structure එකක් සකස් කිරීම. - භාවිතා කරන අවස්ථාව (When to use): Coding tutorials / course content සාදන විට. [38] /setup-pre-commit ---------------------------------------------------------------------------------------------------- - ඉංග්‍රීසි (English): Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests. - සිංහල තේරුම (Sinhala): Git commit කිරීමට පෙර කේතයේ formatting, linting සහ tests පරීක්ෂා වන Husky pre-commit hooks සැකසීම. - භාවිතා කරන අවස්ථාව (When to use): Project එකට commits දැමීමට පෙර code quality එක තහවුරු කරගැනීමට. ==================================================================================================== සැකසූ දිනය: 2026-10-16 | සකස් කළේ: Antigravity Assistant (Gemini) ====================================================================================================