[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M754MMX5RP4494W44ZEN6YDX":3,"skill-same:01M754MMX5RP4494W44ZEN6YDX":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M754MMX5RP4494W44ZEN6YDX","symbol-surgery",null,"Symbol-first refactoring discipline using the native LSP tool — locate by symbol, check blast radius before changing, edit at symbol boundaries, verify references after. Use when renaming, changing a signature, moving\u002Fextracting\u002Finlining, or deleting code that other code depends on; or whenever the question is \"where is this used and what breaks if I change it?\" Mechanical-execution complement to `deepen` (which decides what to refactor) and `simplify` (which decides what's clean).","nino-chavez\u002Fagentic-ways-of-working","nino-chavez","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12718755?v=4","01M754JW20GYYZXXN5MCEDN4ZF","Nino Chavez","01M754JW30HW4WBYC09HN1HCEX",2,"MIT","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Fsymbol-surgery\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: symbol-surgery\ndescription: Symbol-first refactoring discipline using the native LSP tool — locate by symbol, check blast radius before changing, edit at symbol boundaries, verify references after. Use when renaming, changing a signature, moving\u002Fextracting\u002Finlining, or deleting code that other code depends on; or whenever the question is \"where is this used and what breaks if I change it?\" Mechanical-execution complement to `deepen` (which decides what to refactor) and `simplify` (which decides what's clean).\n---\n\n# Symbol Surgery\n\nThe execution discipline for refactors. `deepen` decides *what* module should change and `simplify` decides *what's clean*; this skill governs *how* the change lands — precisely, with the blast radius known before the first edit.\n\nThe whole point: stop reaching for Grep-then-guess-line-numbers by reflex. You already have a Language Server in this harness (the `LSP` tool). Symbol-granular navigation and scoped editing beat text search on precision and on tokens — no whole-file reads to locate a symbol, no broken call sites discovered after the fact.\n\nThis is the part of Serena worth keeping: symbol-first, blast-radius-aware editing. The 40-language server management is not — the native `LSP` tool already covers navigation in-process, with no MCP roundtrip.\n\n## When to use\n\nUse when the change touches code other code depends on:\n\n- **Rename** a function, class, type, variable, export.\n- **Change a signature** — add\u002Fremove\u002Freorder params, change return type.\n- **Move \u002F extract \u002F inline** a symbol across files.\n- **Delete** a symbol you believe is unused.\n- Answer **\"where is this used and what breaks if I change it?\"**\n\nSkip it for: greenfield writing, a self-contained local edit where you already hold the full context, or non-code text. Don't run heavy navigation on a one-line tweak.\n\n## The native LSP operations\n\nAll operations take `filePath`, `line`, `character` (1-based). `workspaceSymbol` also takes `query`.\n\n| Need | Operation |\n|---|---|\n| Find a symbol's definition | `goToDefinition` |\n| Find every use of a symbol | `findReferences` |\n| Type \u002F doc at a position | `hover` |\n| All symbols in one file (with ranges) | `documentSymbol` |\n| Find a symbol by name across the repo | `workspaceSymbol` (always pass `query`) |\n| Implementations of an interface\u002Fabstract | `goToImplementation` |\n| Who calls this function | `incomingCalls` (after `prepareCallHierarchy`) |\n| What this function calls | `outgoingCalls` |\n\n## Process\n\n### 1. Locate — never guess a line range\n\nTo act on a symbol, first get its real identity and span:\n\n- In a known file: `documentSymbol` returns every symbol with its range. Edit at those boundaries.\n- By name across the repo: `workspaceSymbol` with `query`.\n- Unsure what a name refers to: `hover` \u002F `goToDefinition`.\n\nThis replaces reading the whole file to find where something lives.\n\n### 2. Blast radius — before you change anything\n\nFor any rename, signature change, move, or delete, enumerate callers **first**:\n\n- `findReferences` on the symbol → every use site.\n- `incomingCalls` (via `prepareCallHierarchy`) → the call graph reaching it, when references alone undersell the coupling.\n\nThis is the step that prevents the classic \"renamed it, broke six call sites you didn't know about.\" If the reference list is larger than expected, that *is* the finding — surface it before editing.\n\n### 3. Edit at symbol scope\n\nThe symbol-level editors Serena ships are compositions of tools you already have. Use these recipes:\n\n- **Replace a symbol's body** → `documentSymbol` to get the range, then `Edit` that range. Don't hand-count lines.\n- **Insert before\u002Fafter a symbol** → `documentSymbol` for the boundary, then `Edit` at it.\n- **Safe-delete** → `findReferences` to assert zero callers (or migrate them first), then `Edit` to remove. Never delete on the assumption it's dead — prove it.\n- **Rename \u002F signature change** → edit the definition, then `Edit` every site from step 2. The reference list is your checklist.\n\n### 4. Verify — references, not vibes\n\nAfter the edit, confirm the change is complete and consistent:\n\n- Rename: `findReferences` on the **old** name returns zero; the **new** name returns the count you expected.\n- Signature change: `hover` \u002F type-check resolves at the call sites you touched.\n- Delete: `findReferences` returns zero (it should, since step 3 proved it).\n\nDon't declare a refactor done until the references say it is.\n\n## When LSP isn't available\n\nThe language server must be configured for the file type, or the operation errors. If it's unavailable, fall back to `Grep` for navigation — but say so, and treat the blast radius as *approximate*. Grep finds text matches, not semantic references: it misses re-exports and aliasing, and it produces false hits on comments and same-named-but-unrelated symbols. State the reduced confidence rather than implying full coverage.\n\n## Relationship to other skills\n\n- **`deepen`** — decides which modules should be reshaped (depth\u002Fleverage). Hand its chosen refactor to this skill to execute.\n- **`simplify`** — code-quality cleanups on a diff. This skill is how those cleanups land safely when they cross call sites.\n- **`diagnose`** — when the refactor is in service of a bug, diagnose first, then operate.\n- **`blast-radius`** — what breaks where references stop: wire formats, data at rest, library internals, consumers outside the repo. Run it when the reference list looks clean and the change still feels risky.\n","# Symbol Surgery\n\nThe execution discipline for refactors. `deepen` decides *what* module should change and `simplify` decides *what's clean*; this skill governs *how* the change lands — precisely, with the blast radius known before the first edit.\n\nThe whole point: stop reaching for Grep-then-guess-line-numbers by reflex. You already have a Language Server in this harness (the `LSP` tool). Symbol-granular navigation and scoped editing beat text search on precision and on tokens — no whole-file reads to locate a symbol, no broken call sites discovered after the fact.\n\nThis is the part of Serena worth keeping: symbol-first, blast-radius-aware editing. The 40-language server management is not — the native `LSP` tool already covers navigation in-process, with no MCP roundtrip.\n\n## When to use\n\nUse when the change touches code other code depends on:\n\n- **Rename** a function, class, type, variable, export.\n- **Change a signature** — add\u002Fremove\u002Freorder params, change return type.\n- **Move \u002F extract \u002F inline** a symbol across files.\n- **Delete** a symbol you believe is unused.\n- Answer **\"where is this used and what breaks if I change it?\"**\n\nSkip it for: greenfield writing, a self-contained local edit where you already hold the full context, or non-code text. Don't run heavy navigation on a one-line tweak.\n\n## The native LSP operations\n\nAll operations take `filePath`, `line`, `character` (1-based). `workspaceSymbol` also takes `query`.\n\n| Need | Operation |\n|---|---|\n| Find a symbol's definition | `goToDefinition` |\n| Find every use of a symbol | `findReferences` |\n| Type \u002F doc at a position | `hover` |\n| All symbols in one file (with ranges) | `documentSymbol` |\n| Find a symbol by name across the repo | `workspaceSymbol` (always pass `query`) |\n| Implementations of an interface\u002Fabstract | `goToImplementation` |\n| Who calls this function | `incomingCalls` (after `prepareCallHierarchy`) |\n| What this function calls | `outgoingCalls` |\n\n## Process\n\n### 1. Locate — never guess a line range\n\nTo act on a symbol, first get its real identity and span:\n\n- In a known file: `documentSymbol` returns every symbol with its range. Edit at those boundaries.\n- By name across the repo: `workspaceSymbol` with `query`.\n- Unsure what a name refers to: `hover` \u002F `goToDefinition`.\n\nThis replaces reading the whole file to find where something lives.\n\n### 2. Blast radius — before you change anything\n\nFor any rename, signature change, move, or delete, enumerate callers **first**:\n\n- `findReferences` on the symbol → every use site.\n- `incomingCalls` (via `prepareCallHierarchy`) → the call graph reaching it, when references alone undersell the coupling.\n\nThis is the step that prevents the classic \"renamed it, broke six call sites you didn't know about.\" If the reference list is larger than expected, that *is* the finding — surface it before editing.\n\n### 3. Edit at symbol scope\n\nThe symbol-level editors Serena ships are compositions of tools you already have. Use these recipes:\n\n- **Replace a symbol's body** → `documentSymbol` to get the range, then `Edit` that range. Don't hand-count lines.\n- **Insert before\u002Fafter a symbol** → `documentSymbol` for the boundary, then `Edit` at it.\n- **Safe-delete** → `findReferences` to assert zero callers (or migrate them first), then `Edit` to remove. Never delete on the assumption it's dead — prove it.\n- **Rename \u002F signature change** → edit the definition, then `Edit` every site from step 2. The reference list is your checklist.\n\n### 4. Verify — references, not vibes\n\nAfter the edit, confirm the change is complete and consistent:\n\n- Rename: `findReferences` on the **old** name returns zero; the **new** name returns the count you expected.\n- Signature change: `hover` \u002F type-check resolves at the call sites you touched.\n- Delete: `findReferences` returns zero (it should, since step 3 proved it).\n\nDon't declare a refactor done until the references say it is.\n\n## When LSP isn't available\n\nThe language server must be configured for the file type, or the operation errors. If it's unavailable, fall back to `Grep` for navigation — but say so, and treat the blast radius as *approximate*. Grep finds text matches, not semantic references: it misses re-exports and aliasing, and it produces false hits on comments and same-named-but-unrelated symbols. State the reduced confidence rather than implying full coverage.\n\n## Relationship to other skills\n\n- **`deepen`** — decides which modules should be reshaped (depth\u002Fleverage). Hand its chosen refactor to this skill to execute.\n- **`simplify`** — code-quality cleanups on a diff. This skill is how those cleanups land safely when they cross call sites.\n- **`diagnose`** — when the refactor is in service of a bug, diagnose first, then operate.\n- **`blast-radius`** — what breaks where references stop: wire formats, data at rest, library internals, consumers outside the repo. Run it when the reference list looks clean and the change still feels risky.\n",{"name":5,"description":7},"main","6ccdd47a6d908bb540b44198221fabf7a71f7bba","skills\u002Fsymbol-surgery",0,"https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working#readme","https:\u002F\u002Fgithub.com\u002Fnino-chavez","https:\u002F\u002Fninochavez.co","Enterprise Architect & AI Systems Designer | Action Sports Photographer. Building human-AI systems that scale.","2026-11-14 02:34:16",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add nino-chavez\u002Fagentic-ways-of-working --skill symbol-surgery",{"tool":40,"command":41},"bunx","bunx skills add nino-chavez\u002Fagentic-ways-of-working --skill symbol-surgery",{"tool":43,"command":44},"pnpm","pnpm dlx skills add nino-chavez\u002Fagentic-ways-of-working --skill symbol-surgery","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Fsymbol-surgery\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M754N3A73KPE25NE31Z2XP3M","zoom-out","Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-out\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M754N16FXP38FVD365N0MFT4","write-a-skill","Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Fwrite-a-skill\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M754MXZNPAN5VY4VGQT37APS","triage","Triage issues through a state machine driven by triage roles. Use when user wants to create an issue, triage issues, review incoming bugs or feature requests, prepare issues for an AFK agent, or manage issue workflow.","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Ftriage\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M754MT24EMZEFB3M6VKZ0KZ1","tdd","Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions \"red-green-refactor\", wants integration tests, or asks for test-first development.","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Ftdd\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M754MGZR49W94V1SW4GTG20G","ship","Deploy, release, or run migrations against production for a project. Use when user says \"deploy\", \"ship\", \"push to prod\", \"release\", \"run the migration\", \"apply migrations\", or asks how a project gets deployed \u002F where it lives. Reads per-project DEPLOY.md as source of truth; falls back to inference + offer to scaffold one.","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Fship\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M754MDNMQCCZDQDJD91SR8CQ","session-closeout","Preserve durable lessons and produce an archive-safety receipt before ending, clearing, or archiving an agent task. Use without being asked when a task reaches its finish line (its PR merged and its worktree removed, or the deliverable handed over), and when the operator says close out, wrap up, end the session, prepare the task for archive, make it archive-ready, or invokes $session-closeout after substantive work.","https:\u002F\u002Fgithub.com\u002Fnino-chavez\u002Fagentic-ways-of-working\u002Fblob\u002Fmain\u002Fskills\u002Fsession-closeout\u002FSKILL.md",[],[]]