[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79TP4K88S3CKM7R08AR3RPX":3,"skill-same:01M79TP4K88S3CKM7R08AR3RPX":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M79TP4K88S3CKM7R08AR3RPX","understand-explain",null,"Use when you need a deep-dive explanation of a specific file, function, or module in the codebase","nahid-sparktales\u002Flocus","nahid-sparktales","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F278225096?v=4","01M79TH2FX7X29N8H3X182C80G","01M79TH2H2GAQMG6QSF80M16G8",22,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Funderstand-anything\u002Fupstream\u002Fskills\u002Funderstand-explain\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: understand-explain\ndescription: Use when you need a deep-dive explanation of a specific file, function, or module in the codebase\nargument-hint: \"[file-path]\"\n---\n\n# \u002Funderstand-explain\n\nProvide a thorough, in-depth explanation of a specific code component.\n\n## Graph Structure Reference\n\nThe knowledge graph JSON has this structure:\n- `project` — {name, description, languages, frameworks, analyzedAt, gitCommitHash}\n- `nodes[]` — each has {id, type, name, filePath?, summary, tags[], complexity, languageNotes?}\n  - Code node types: file, function, class, module, concept\n  - Non-code node types: config, document, service, table, endpoint, pipeline, schema, resource\n  - Domain\u002Fknowledge node types: domain, flow, step, article, entity, topic, claim, source\n  - IDs use the node type as prefix, e.g. `file:path`, `function:path:name`, `config:path`, `article:path`\n- `edges[]` — each has {source, target, type, direction, weight}\n  - Key types: imports, contains, calls, depends_on, configures, documents, deploys, triggers, contains_flow, flow_step, related, cites\n- `layers[]` — each has {id, name, description, nodeIds[]}\n- `tour[]` — each has {order, title, description, nodeIds[]}\n\n## How to Read Efficiently\n\n1. Use Grep to search within the JSON for relevant entries BEFORE reading the full file\n2. Only read sections you need — don't dump the entire graph into context\n3. Node names and summaries are the most useful fields for understanding\n4. Edges tell you how components connect — follow imports and calls for dependency chains\n\n## Instructions\n\n1. **Resolve the data directory `$UA_DIR`.** Run `UA_DIR=$([ -d .understand-anything ] && echo .understand-anything || echo .ua)` — this is the legacy `.understand-anything\u002F` when it already exists, otherwise the new `.ua\u002F`. Check that `$UA_DIR\u002Fknowledge-graph.json` exists. If not, tell the user to run `\u002Funderstand` first.\n\n2. **Check graph freshness before using graph-derived context**:\n   - Read `project.gitCommitHash` from the graph metadata as `GRAPH_COMMIT_RAW`. Resolve it as a commit before using it in any Git diff, then compare it with `git rev-parse HEAD` and inspect project-scoped committed and working-tree changes from the project root:\n     ```bash\n     GRAPH_COMMIT=$(git rev-parse --verify --end-of-options \"${GRAPH_COMMIT_RAW}^{commit}\" 2>\u002Fdev\u002Fnull)\n     git rev-parse HEAD\n     git diff --name-only \"$GRAPH_COMMIT\" HEAD -- .\n     git diff --cached --name-only -- .\n     git diff --name-only -- .\n     git ls-files --others --exclude-standard -- .\n     ```\n   - The `-- .` pathspec is required: commits that only touch a sibling monorepo project must not make this graph stale. A hash mismatch alone is not stale when the project diff is empty.\n   - Ignore the selected data directory (`.ua\u002F` or legacy `.understand-anything\u002F`) in every command's output because it contains generated graph artifacts, not project source drift.\n   - If the committed diff or any working-tree command reports project files, warn before explaining that graph-derived context may omit those changes. Suggest: Run `\u002Funderstand` to refresh the graph.\n   - Run the commit diff only when `GRAPH_COMMIT_RAW` resolves successfully. If the graph commit or Git metadata is missing, invalid, or unavailable, give a brief best-effort warning and continue instead of blocking.\n\n3. **Find the target node** — use Grep to search the knowledge graph for the component: \"$ARGUMENTS\"\n   - For file paths (e.g., `src\u002Fauth\u002Flogin.ts`): search for `\"filePath\"` matches\n   - For function notation (e.g., `src\u002Fauth\u002Flogin.ts:verifyToken`): search for the function name in `\"name\"` fields filtered by the file path\n   - Note the exact node `id`, `type`, `summary`, `tags`, and `complexity`\n\n4. **Find all connected edges** — Grep for the target node's ID in the edges section:\n   - `\"source\"` matches → things this node calls\u002Fimports\u002Fdepends on (outgoing)\n   - `\"target\"` matches → things that call\u002Fimport\u002Fdepend on this node (incoming)\n   - Note the connected node IDs and edge types\n\n5. **Read connected nodes** — for each connected node ID from step 4, Grep for those IDs in the nodes section to get their `name`, `summary`, and `type`. This builds the component's neighborhood.\n\n6. **Identify the layer** — Grep for the target node's ID in the `\"layers\"` section to find which architectural layer it belongs to and that layer's description.\n\n7. **Read the actual source file** — Read the source file at the node's `filePath` for the deep-dive analysis.\n\n8. **Explain the component in context**:\n   - Its role in the architecture (which layer, why it exists)\n   - Internal structure (functions, classes it contains — from `contains` edges)\n   - External connections (what it imports, what calls it, what it depends on — from edges)\n   - Data flow (inputs → processing → outputs — from source code)\n   - Explain clearly, assuming the reader may not know the programming language\n   - Highlight any patterns, idioms, or complexity worth understanding\n","# \u002Funderstand-explain\n\nProvide a thorough, in-depth explanation of a specific code component.\n\n## Graph Structure Reference\n\nThe knowledge graph JSON has this structure:\n- `project` — {name, description, languages, frameworks, analyzedAt, gitCommitHash}\n- `nodes[]` — each has {id, type, name, filePath?, summary, tags[], complexity, languageNotes?}\n  - Code node types: file, function, class, module, concept\n  - Non-code node types: config, document, service, table, endpoint, pipeline, schema, resource\n  - Domain\u002Fknowledge node types: domain, flow, step, article, entity, topic, claim, source\n  - IDs use the node type as prefix, e.g. `file:path`, `function:path:name`, `config:path`, `article:path`\n- `edges[]` — each has {source, target, type, direction, weight}\n  - Key types: imports, contains, calls, depends_on, configures, documents, deploys, triggers, contains_flow, flow_step, related, cites\n- `layers[]` — each has {id, name, description, nodeIds[]}\n- `tour[]` — each has {order, title, description, nodeIds[]}\n\n## How to Read Efficiently\n\n1. Use Grep to search within the JSON for relevant entries BEFORE reading the full file\n2. Only read sections you need — don't dump the entire graph into context\n3. Node names and summaries are the most useful fields for understanding\n4. Edges tell you how components connect — follow imports and calls for dependency chains\n\n## Instructions\n\n1. **Resolve the data directory `$UA_DIR`.** Run `UA_DIR=$([ -d .understand-anything ] && echo .understand-anything || echo .ua)` — this is the legacy `.understand-anything\u002F` when it already exists, otherwise the new `.ua\u002F`. Check that `$UA_DIR\u002Fknowledge-graph.json` exists. If not, tell the user to run `\u002Funderstand` first.\n\n2. **Check graph freshness before using graph-derived context**:\n   - Read `project.gitCommitHash` from the graph metadata as `GRAPH_COMMIT_RAW`. Resolve it as a commit before using it in any Git diff, then compare it with `git rev-parse HEAD` and inspect project-scoped committed and working-tree changes from the project root:\n     ```bash\n     GRAPH_COMMIT=$(git rev-parse --verify --end-of-options \"${GRAPH_COMMIT_RAW}^{commit}\" 2>\u002Fdev\u002Fnull)\n     git rev-parse HEAD\n     git diff --name-only \"$GRAPH_COMMIT\" HEAD -- .\n     git diff --cached --name-only -- .\n     git diff --name-only -- .\n     git ls-files --others --exclude-standard -- .\n     ```\n   - The `-- .` pathspec is required: commits that only touch a sibling monorepo project must not make this graph stale. A hash mismatch alone is not stale when the project diff is empty.\n   - Ignore the selected data directory (`.ua\u002F` or legacy `.understand-anything\u002F`) in every command's output because it contains generated graph artifacts, not project source drift.\n   - If the committed diff or any working-tree command reports project files, warn before explaining that graph-derived context may omit those changes. Suggest: Run `\u002Funderstand` to refresh the graph.\n   - Run the commit diff only when `GRAPH_COMMIT_RAW` resolves successfully. If the graph commit or Git metadata is missing, invalid, or unavailable, give a brief best-effort warning and continue instead of blocking.\n\n3. **Find the target node** — use Grep to search the knowledge graph for the component: \"$ARGUMENTS\"\n   - For file paths (e.g., `src\u002Fauth\u002Flogin.ts`): search for `\"filePath\"` matches\n   - For function notation (e.g., `src\u002Fauth\u002Flogin.ts:verifyToken`): search for the function name in `\"name\"` fields filtered by the file path\n   - Note the exact node `id`, `type`, `summary`, `tags`, and `complexity`\n\n4. **Find all connected edges** — Grep for the target node's ID in the edges section:\n   - `\"source\"` matches → things this node calls\u002Fimports\u002Fdepends on (outgoing)\n   - `\"target\"` matches → things that call\u002Fimport\u002Fdepend on this node (incoming)\n   - Note the connected node IDs and edge types\n\n5. **Read connected nodes** — for each connected node ID from step 4, Grep for those IDs in the nodes section to get their `name`, `summary`, and `type`. This builds the component's neighborhood.\n\n6. **Identify the layer** — Grep for the target node's ID in the `\"layers\"` section to find which architectural layer it belongs to and that layer's description.\n\n7. **Read the actual source file** — Read the source file at the node's `filePath` for the deep-dive analysis.\n\n8. **Explain the component in context**:\n   - Its role in the architecture (which layer, why it exists)\n   - Internal structure (functions, classes it contains — from `contains` edges)\n   - External connections (what it imports, what calls it, what it depends on — from edges)\n   - Data flow (inputs → processing → outputs — from source code)\n   - Explain clearly, assuming the reader may not know the programming language\n   - Highlight any patterns, idioms, or complexity worth understanding\n",{"name":5,"description":7,"argument-hint":23},"[file-path]","main","f208867dc28cb250af1bb839cc9eb78d5bdf8df1","agent\u002Follama_code\u002Fbuiltin_skills\u002Funderstand-anything\u002Fupstream\u002Fskills\u002Funderstand-explain",1,"https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus","https:\u002F\u002Flocushost.co","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales","2026-10-23 06:15:17",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add nahid-sparktales\u002Flocus --skill understand-explain",{"tool":38,"command":39},"bunx","bunx skills add nahid-sparktales\u002Flocus --skill understand-explain",{"tool":41,"command":42},"pnpm","pnpm dlx skills add nahid-sparktales\u002Flocus --skill understand-explain","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Funderstand-anything\u002Fupstream\u002Fskills\u002Funderstand-explain\u002FSKILL.md",true,[],[47,56,64,72,80,88],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":51,"licenseFileUrl":52,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M79TQNH2XPDQRDZCJKZ5FMQY","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","MIT","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fwriting-skills\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":51,"licenseFileUrl":60,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M79TQH62FT3Q5WNFSNYPHW5Q","writing-plans","Prepare a saved implementation plan for a substantial multi-step request.","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fwriting-plans\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":51,"licenseFileUrl":68,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M79TQBAG6D20EPN45KZ2G1Y5","verification-before-completion","Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fverification-before-completion\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":51,"licenseFileUrl":76,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M79TQ2TH5FW4KQZ5194BB961","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fvercel-react-best-practices\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fvercel-react-best-practices\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":51,"licenseFileUrl":84,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M79TPXZHP81WAXKW9CVMXACB","using-superpowers","Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fusing-superpowers\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fusing-superpowers\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":51,"licenseFileUrl":92,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M79TPR4TSQ1YXAPRXR0778HV","using-git-worktrees","Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fusing-git-worktrees\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fnahid-sparktales\u002Flocus\u002Fblob\u002Fmain\u002Fagent\u002Follama_code\u002Fbuiltin_skills\u002Fusing-git-worktrees\u002FSKILL.md",[],[]]