[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77Y19FK01RJD3ZPW4VQN18M":3,"skill-same:01M77Y19FK01RJD3ZPW4VQN18M":47},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M77Y19FK01RJD3ZPW4VQN18M","axum-standards",null,"Use when building an Axum (or Actix-web) async Rust web service in a touchstone repo — routing, extractors, Tower middleware, IntoResponse errors, state\u002FDI, graceful shutdown. Triggers on `axum`\u002F`actix-web` in Cargo.toml, `Router`\u002F`async fn` HTTP handlers, `State`\u002F`Json`\u002F`Path` extractors. Rust-language rules (toolchain, clippy, thiserror, tokio depth) live in the rust skill.","hwanngo\u002Ftouchstone","hwanngo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F40811995?v=4","01M77Y071N2D3A6BMB2GVS4F36","01M77Y072AAS1FW736DJ42EP5S",0,"MIT","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Fskills\u002Faxum-standards\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: axum-standards\ndescription: Use when building an Axum (or Actix-web) async Rust web service in a touchstone repo — routing, extractors, Tower middleware, IntoResponse errors, state\u002FDI, graceful shutdown. Triggers on `axum`\u002F`actix-web` in Cargo.toml, `Router`\u002F`async fn` HTTP handlers, `State`\u002F`Json`\u002F`Path` extractors. Rust-language rules (toolchain, clippy, thiserror, tokio depth) live in the rust skill.\nlicense: MIT\nmetadata:\n  version: 0.2.0\n  author: touchstone\n---\n\n# Axum (Rust Backend framework)\n\nFull standard: **`standards\u002Fframeworks\u002Faxum.md`** (layers on `standards\u002Flanguages\u002Frust.md`). This\nskill inlines the load-bearing rules so it stays useful when installed standalone in\n`~\u002F.claude\u002Fskills\u002F`:\n\n## Always\n- **Axum 0.8 is the default** (on Tokio\u002FTower\u002FHyper); Actix-web is the measured escape hatch. Path\n  syntax is **`\u002F{id}`**, not 0.7's `\u002F:id`.\n- **handler → service → repository** layering; thin handlers delegate and return `Result\u003CT, AppError>`\n  via `?`. Split `lib` from `bin`.\n- **`State\u003CAppState>`** is the DI container — cheap-Clone behind `Arc`\u002Fpools, built once in `main`, no\n  static singletons; sub-states via `FromRef`.\n- **Typed extractors** (`Path`\u002F`Query`\u002F`Json`); at most one body extractor and it goes **last**;\n  route rejections through `AppError`.\n- **Validate every boundary** (`garde`\u002F`validator`) in a shared extractor before the service runs.\n\n## Don't get burned\n- **Errors:** one `AppError` implementing `IntoResponse` (thiserror), maps source → status in one\n  place → problem+json. **No `unwrap()`\u002F`expect()` in handlers** (see rust skill §4); never leak a\n  `sqlx::Error` or stack trace to the client.\n- **Middleware:** compose with `ServiceBuilder` — **top-to-bottom = outermost-to-innermost**.\n  `TraceLayer` outermost, then CORS (explicit allow-list, never `Any` in prod) + body-limit +\n  `TimeoutLayer`, auth innermost.\n- **Async:** all rust-skill tokio rules apply — never block the executor, bound awaits with\n  `tokio::time::timeout`, make handler work cancel-safe (the client disconnecting drops the future).\n- **Shutdown:** `axum::serve(...).with_graceful_shutdown(signal)` on `SIGTERM` **and** Ctrl-C; close\n  the pool after drain; bound by the request timeout.\n- **DB:** `sqlx` compile-checked queries in the repository (SeaORM only at scale); migrations at\n  deploy, not on first request.\n\n## Done\nHandler → service → repo · typed extractors (body last) · one `AppError: IntoResponse`, no `unwrap` in handlers · `ServiceBuilder` ordering (Trace outer, auth inner) + explicit CORS · `with_graceful_shutdown` on SIGTERM+Ctrl-C · `oneshot` handler tests + Testcontainers for DB. See `standards\u002Fframeworks\u002Faxum.md`.\n","# Axum (Rust Backend framework)\n\nFull standard: **`standards\u002Fframeworks\u002Faxum.md`** (layers on `standards\u002Flanguages\u002Frust.md`). This\nskill inlines the load-bearing rules so it stays useful when installed standalone in\n`~\u002F.claude\u002Fskills\u002F`:\n\n## Always\n- **Axum 0.8 is the default** (on Tokio\u002FTower\u002FHyper); Actix-web is the measured escape hatch. Path\n  syntax is **`\u002F{id}`**, not 0.7's `\u002F:id`.\n- **handler → service → repository** layering; thin handlers delegate and return `Result\u003CT, AppError>`\n  via `?`. Split `lib` from `bin`.\n- **`State\u003CAppState>`** is the DI container — cheap-Clone behind `Arc`\u002Fpools, built once in `main`, no\n  static singletons; sub-states via `FromRef`.\n- **Typed extractors** (`Path`\u002F`Query`\u002F`Json`); at most one body extractor and it goes **last**;\n  route rejections through `AppError`.\n- **Validate every boundary** (`garde`\u002F`validator`) in a shared extractor before the service runs.\n\n## Don't get burned\n- **Errors:** one `AppError` implementing `IntoResponse` (thiserror), maps source → status in one\n  place → problem+json. **No `unwrap()`\u002F`expect()` in handlers** (see rust skill §4); never leak a\n  `sqlx::Error` or stack trace to the client.\n- **Middleware:** compose with `ServiceBuilder` — **top-to-bottom = outermost-to-innermost**.\n  `TraceLayer` outermost, then CORS (explicit allow-list, never `Any` in prod) + body-limit +\n  `TimeoutLayer`, auth innermost.\n- **Async:** all rust-skill tokio rules apply — never block the executor, bound awaits with\n  `tokio::time::timeout`, make handler work cancel-safe (the client disconnecting drops the future).\n- **Shutdown:** `axum::serve(...).with_graceful_shutdown(signal)` on `SIGTERM` **and** Ctrl-C; close\n  the pool after drain; bound by the request timeout.\n- **DB:** `sqlx` compile-checked queries in the repository (SeaORM only at scale); migrations at\n  deploy, not on first request.\n\n## Done\nHandler → service → repo · typed extractors (body last) · one `AppError: IntoResponse`, no `unwrap` in handlers · `ServiceBuilder` ordering (Trace outer, auth inner) + explicit CORS · `with_graceful_shutdown` on SIGTERM+Ctrl-C · `oneshot` handler tests + Testcontainers for DB. See `standards\u002Fframeworks\u002Faxum.md`.\n",{"name":5,"license":14,"metadata":23,"description":7},{"author":24,"version":25},"touchstone","0.2.0","main","d733e177953000560b4cee8f6c01c63aa7a498f0","skills\u002Faxum-standards","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone","https:\u002F\u002Fgithub.com\u002Fhwanngo","\"There is always one more bug to fix.\"","2026-08-26 01:16:05",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add hwanngo\u002Ftouchstone --skill axum-standards",{"tool":39,"command":40},"bunx","bunx skills add hwanngo\u002Ftouchstone --skill axum-standards",{"tool":42,"command":43},"pnpm","pnpm dlx skills add hwanngo\u002Ftouchstone --skill axum-standards","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Fskills\u002Faxum-standards\u002FSKILL.md",true,[],[48,55,62,67,72,77],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":18},"01M77YA15EH4A1SDYPZSPZSE8V","ok-standards","Use when writing shell, per standards\u002Flanguages\u002Fshell.md.","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fstandards-known-good\u002Fskills\u002Fok-standards\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M77Y9YK8K580BZ6GNZP6N0PW","demo-standards","Use when editing demo code in a touchstone fixture repo, a deliberately ordinary description that is long enough to clear the forty character minimum.","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-url-ignored\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":63,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M77Y9VKRQH1CD8B7Y1BZX0PX","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-stray-xml\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":68,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M77Y9SZBHZJES7014P5W1A33","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-pointer-sentence-period\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":73,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M77Y9Q6PRTYDTPR8EK0TMJC6","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-pointer-relative-dead\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[],{"skillNo":78,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M77Y9NH1Z2528QQ6VQ45G6RV","https:\u002F\u002Fgithub.com\u002Fhwanngo\u002Ftouchstone\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills-pointer-outside-repo\u002Fskills\u002Fdemo-standards\u002FSKILL.md",[],[]]