improve open-source readiness

- upgrade README with badges, CLI options table, "What You Get" section, links
- add npm keywords for discoverability (ethereum, l2, web3, wagmi, viem, etc.)
- add author field to package.json
- add llms.txt for AI agent discoverability
- add CODEOWNERS

Author: williamhzo

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @shape-network/core

README.md

@@ -1,18 +1,51 @@
 # create-shape-app
 
-CLI for scaffolding Shape apps from the Builder Kit template pinned to release tags.
+[![npm version](https://img.shields.io/npm/v/create-shape-app)](https://www.npmjs.com/package/create-shape-app)
+[![license](https://img.shields.io/npm/l/create-shape-app)](./LICENSE)
+
+CLI for scaffolding [Shape](https://shape.network) apps from the [Builder Kit](https://github.com/shape-network/builder-kit) template.
 
 ## Quick Start
 
-Choose one:
-- `npx create-shape-app`
-- `bunx create-shape-app`
+```bash
+npx create-shape-app my-app
+```
+
+Other package managers:
+
+- `bunx create-shape-app my-app`
+- `pnpm dlx create-shape-app my-app`
+- `yarn create shape-app my-app`
+
+## What You Get
+
+A monorepo with everything needed to build on Shape:
+
+- **`apps/web`** -- Next.js frontend with wagmi, viem, and wallet connection
+- **`packages/contract`** -- Hardhat project with a sample contract, deploy scripts, and tests
+- Pre-configured for Shape mainnet and Shape Sepolia
+- TypeScript throughout, Tailwind CSS styling
+
+## CLI Options
+
+| Flag | Description |
+|------|-------------|
+| `-y, --yes` | Skip confirmation prompts |
+| `--pm <bun\|npm\|pnpm\|yarn>` | Select package manager |
+| `--skip-install` | Skip dependency install step |
+| `--skip-git` | Skip git init + initial commit |
+| `--template-ref <tag>` | Pin to a specific Builder Kit release tag |
+| `-h, --help` | Show help |
+| `-v, --version` | Show version |
+
+If `project-name` is omitted in an interactive terminal, you will be prompted.
+If `--pm` is omitted in an interactive terminal, you can pick a package manager.
 
 ## Behavior
+
 - Scaffolds from `shape-network/builder-kit` release tags only (`latest` by default).
 - Rejects non-release refs (for example `main`) and canary tags.
 - In non-interactive terminals, `--yes` is required.
-- In interactive terminals, package manager is selectable when `--pm` is not provided.
 - Copies template files, excluding VCS/internal maintainer metadata.
 - Applies defaults:
   - Root `package.json` name is set from the project directory name.
@@ -21,6 +54,7 @@ Choose one:
   - Git is initialized unless `--skip-git` is set.
 
 ## Troubleshooting
+
 - GitHub API rate limit during template lookup:
   - retry later, set `GITHUB_TOKEN`, or pass `--template-ref <tag>`.
 - Git init or commit failure:
@@ -38,12 +72,21 @@ bun run test
 ```
 
 ## Publish
+
 - Trigger: GitHub release publish event.
 - Guard: workflow checks release tag matches `package.json` version.
 - Requirement: repository secret `NPM_TOKEN` must be configured.
 - Publish target: npm package `create-shape-app`.
 
+## Links
+
+- [Shape](https://shape.network)
+- [Shape docs](https://docs.shape.network)
+- [Shape Discord](http://discord.com/invite/shape-l2)
+- [Builder Kit](https://github.com/shape-network/builder-kit)
+
 ## Community
+
 - Contribution guide: `CONTRIBUTING.md`
 - Security policy: `SECURITY.md`
 - Code of conduct: `CODE_OF_CONDUCT.md`

llms.txt

@@ -0,0 +1,50 @@
+# create-shape-app
+
+> CLI for scaffolding Shape apps from the Builder Kit template.
+
+Shape is an EVM-compatible L2 built on the OP Stack.
+create-shape-app downloads the latest release of builder-kit and sets up a ready-to-run monorepo.
+
+## Quick Start
+
+- npx create-shape-app my-app
+- bunx create-shape-app my-app
+- pnpm dlx create-shape-app my-app
+- yarn create shape-app my-app
+
+## CLI Options
+
+- -y, --yes: Skip confirmation prompts
+- --pm <bun|npm|pnpm|yarn>: Select package manager
+- --skip-install: Skip dependency install step
+- --skip-git: Skip git init and initial commit
+- --template-ref <tag>: Pin to a specific Builder Kit release tag
+- -h, --help: Show help
+- -v, --version: Show version
+
+## What It Scaffolds
+
+A monorepo with two workspaces:
+
+- apps/web: Next.js frontend with wagmi, viem, RainbowKit, and Tailwind CSS
+- packages/contract: Hardhat project with a sample Solidity contract, deploy scripts, and tests
+
+Pre-configured for Shape mainnet (chain ID 360) and Shape Sepolia (chain ID 11011).
+
+## Behavior
+
+- Downloads from shape-network/builder-kit GitHub release tags only.
+- Rejects non-release refs and canary tags.
+- Copies .env.example to .env when present.
+- Installs dependencies unless --skip-install is set.
+- Initializes git unless --skip-git is set.
+- Requires --yes in non-interactive terminals (CI).
+
+## Links
+
+- Source: https://github.com/shape-network/create-shape-app
+- npm: https://www.npmjs.com/package/create-shape-app
+- Builder Kit: https://github.com/shape-network/builder-kit
+- Shape: https://shape.network
+- Shape docs: https://docs.shape.network
+- Shape Discord: http://discord.com/invite/shape-l2

package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-shape-app",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Scaffold Shape Builder Kit projects from pinned release tags.",
   "license": "MIT",
   "repository": {
@@ -11,12 +11,22 @@
     "url": "https://github.com/shape-network/create-shape-app/issues"
   },
   "homepage": "https://github.com/shape-network/create-shape-app#readme",
+  "author": "williamhzo",
   "keywords": [
     "cli",
     "create",
     "scaffold",
     "shape",
-    "builder-kit"
+    "builder-kit",
+    "ethereum",
+    "l2",
+    "web3",
+    "onchain",
+    "nextjs",
+    "hardhat",
+    "wagmi",
+    "viem",
+    "dapp"
   ],
   "publishConfig": {
     "access": "public"
@@ -26,6 +36,7 @@
   "files": [
     "bin",
     "dist",
+    "llms.txt",
     "README.md",
     "LICENSE"
   ],