Skip to content

code-yeongyu/oh-my-openagent / packages/shared-skills/skills/programming

programming

Flagged

Applies strict, modern language practice (typed errors, exhaustive match, tests that can fail) for Python, Rust, TypeScript, JavaScript, and Go. Use for work on .py, .rs, .ts, .js, or .go files, and whenever a test or spec file is written, reshaped, reviewed, or deleted: the four-question test authoring gate and the junk-test classes live here.

FileKindSize
SKILL.mdskill md33.3 KB
references/code-smells.mdmarkdown13.9 KB
references/go/README.mdmarkdown7.7 KB
references/go/backend-stack.mdmarkdown16.6 KB
references/go/bootstrap.mdmarkdown8.9 KB
references/go/bubbletea-v2.mdmarkdown11.3 KB
references/go/cobra-stack.mdmarkdown11.5 KB
references/go/concurrency.mdmarkdown10.9 KB
references/go/data-modeling.mdmarkdown12.0 KB
references/go/error-handling.mdmarkdown10.1 KB
references/go/golangci-strict.mdmarkdown10.0 KB
references/go/grpc-connect.mdmarkdown10.3 KB
references/go/libraries.mdmarkdown13.7 KB
references/go/one-liners.mdmarkdown5.5 KB
references/go/sqlc-pgx.mdmarkdown12.7 KB
references/go/testing.mdmarkdown14.2 KB
references/go/type-patterns.mdmarkdown9.5 KB
references/logging.mdmarkdown10.5 KB
references/python/README.mdmarkdown15.7 KB
references/python/async-anyio.mdmarkdown14.2 KB
references/python/data-modeling.mdmarkdown6.6 KB
references/python/data-processing.mdmarkdown4.2 KB
references/python/error-handling.mdmarkdown6.0 KB
references/python/fastapi-stack.mdmarkdown9.2 KB
references/python/httpx2-optimization.mdmarkdown12.0 KB
references/python/libraries.mdmarkdown10.6 KB
references/python/one-liners.mdmarkdown7.9 KB
references/python/orjson-stack.mdmarkdown13.3 KB
references/python/pydantic-ai.mdmarkdown8.2 KB
references/python/pyproject-strict.mdmarkdown9.0 KB
references/python/textual-tui.mdmarkdown5.1 KB
references/python/type-patterns.mdmarkdown4.1 KB
references/rust-ub/README.mdmarkdown9.9 KB
references/rust-ub/miri-sanitizers-loom.mdmarkdown11.5 KB
references/rust-ub/ub-taxonomy.mdmarkdown13.3 KB
references/rust/README.mdmarkdown16.6 KB
references/rust/api-design.mdmarkdown6.5 KB
references/rust/async-tokio.mdmarkdown12.6 KB
references/rust/axum-stack.mdmarkdown14.2 KB
references/rust/cargo-strict.mdmarkdown10.0 KB
references/rust/clap-stack.mdmarkdown12.1 KB
references/rust/concurrency.mdmarkdown14.3 KB
references/rust/libraries.mdmarkdown17.4 KB
references/rust/macros.mdmarkdown3.3 KB
references/rust/one-liners.mdmarkdown7.5 KB
references/rust/proptest-insta.mdmarkdown13.9 KB
references/rust/type-state.mdmarkdown13.1 KB
references/rust/unsafe-discipline.mdmarkdown12.9 KB
references/rust/zero-cost-safety.mdmarkdown16.9 KB
references/testing/README.mdmarkdown10.3 KB
references/testing/junk-classes.mdmarkdown6.2 KB
references/typescript/README.mdmarkdown10.6 KB
references/typescript/backend-hono.mdmarkdown21.2 KB
references/typescript/bootstrap.mdmarkdown6.9 KB
references/typescript/data-modeling.mdmarkdown5.0 KB
references/typescript/error-handling.mdmarkdown4.7 KB
references/typescript/oxc-lint.mdmarkdown7.6 KB
references/typescript/tsconfig-strict.mdmarkdown3.9 KB
references/typescript/type-patterns.mdmarkdown5.2 KB
scripts/go/check-no-excuse-rules.shexecutablescript7.1 KB
scripts/go/new-project.tsscript6.8 KB
scripts/go/templates/.editorconfigother206 B
scripts/go/templates/.golangci.ymlconfig1.5 KB
scripts/go/templates/AGENTS.md.tmplother845 B
scripts/go/templates/README.md.tmplother207 B
scripts/go/templates/Taskfile.ymlconfig706 B
scripts/go/templates/ci.ymlconfig863 B
scripts/go/templates/config.goscript643 B
scripts/go/templates/gitignoreother99 B
scripts/go/templates/main.go.tmplother329 B
scripts/go/templates/run.goscript350 B
scripts/python/check-no-excuse-rules.pyscript24.9 KB
scripts/python/new-project.tsscript6.7 KB
scripts/python/new-script.tsscript4.2 KB
scripts/rust/check-no-excuse-rules.shexecutablescript7.5 KB
scripts/rust/check-no-excuse-rules.test.tsscript3.4 KB
scripts/rust/new-project.tsscript6.1 KB
scripts/scaffolders.test.tsscript4.9 KB
scripts/shared/run-tool.tsscript855 B
scripts/typescript/check-no-excuse-rules.test.tsscript4.0 KB
scripts/typescript/check-no-excuse-rules.tsscript13.1 KB
scripts/typescript/check-test-junk-rules.tsscript5.5 KB
scripts/typescript/check-test-junk.test.tsscript4.9 KB
scripts/typescript/check-test-junk.tsscript5.4 KB
scripts/typescript/mutation-proof.test.tsscript1.9 KB
scripts/typescript/mutation-proof.tsscript6.4 KB
scripts/typescript/new-project.test.tsscript6.8 KB
scripts/typescript/new-project.tsscript3.1 KB
scripts/typescript/oxc/.oxfmtrc.jsonconfig256 B
scripts/typescript/oxc/.oxlintrc.jsonconfig1.7 KB
scripts/typescript/oxc/lint/oxlint-plugin/LICENSEother1.0 KB
scripts/typescript/oxc/lint/oxlint-plugin/index.jsscript288 B
scripts/typescript/oxc/lint/oxlint-plugin/no-em-dash-copy.jsscript785 B
scripts/typescript/oxc/lint/oxlint-plugin/require-suppression-reason.jsscript2.3 KB
scripts/typescript/oxc/tsconfig.jsonconfig794 B

scripts/go/new-project.ts

View on GitHub
#!/usr/bin/env bun
/**
 * Scaffold a new Go project with the canonical strict layout: go.mod (go 1.23),
 * .golangci.yml (v2 strict bundle), Taskfile.yml, cmd/server/main.go,
 * internal/{cmd,config,api,domain,obs} skeletons, and .github/workflows/ci.yml.
 *
 * ─── How to run ───
 * 1. Install Bun: curl -fsSL https://bun.sh/install | bash
 * 2. Run:
 *      bun run new-project.ts myservice
 *      bun run new-project.ts myservice --module github.com/your-org/myservice
 * ──────────────────
 *
 * Templates live in ./templates/. `.tmpl` files take Python string.Template
 * placeholders ($name, ${name}, $$ for a literal $); every other file is copied verbatim.
 * Exit codes: 0 created, 1 scaffold failure, 2 usage error.
 */

import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
import { dirname, join } from "node:path"
import { parseArgs } from "node:util"
import { assertNever, runTool } from "../shared/run-tool.ts"

const USAGE = `Usage: bun run new-project.ts <name> [--path <dir>] [--module <path>] [--purpose <text>]

Arguments:
  name          Project directory and default module name

Options:
  --path        Parent dir (default: current dir)
  --module      Go module path (default: <name>)
  --purpose     Short purpose for AGENTS.md (default: HTTP)
  -h, --help    Show this help`

const TEMPLATES_DIR = join(import.meta.dir, "templates")

const LAYOUT = [
  "cmd/server",
  "internal/cmd",
  "internal/config",
  "internal/api",
  "internal/domain",
  "internal/obs",
  ".github/workflows",
] as const

const FILES = [
  { template: ".golangci.yml", output: ".golangci.yml", substitute: false },
  { template: "Taskfile.yml", output: "Taskfile.yml", substitute: false },
  { template: ".editorconfig", output: ".editorconfig", substitute: false },
  { template: "gitignore", output: ".gitignore", substitute: false },
  { template: "ci.yml", output: ".github/workflows/ci.yml", substitute: false },
  { template: "run.go", output: "internal/cmd/run.go", substitute: false },
  { template: "config.go", output: "internal/config/config.go", substitute: false },
  { template: "main.go.tmpl", output: "cmd/server/main.go", substitute: true },
  { template: "AGENTS.md.tmpl", output: "AGENTS.md", substitute: true },
  { template: "README.md.tmpl", output: "README.md", substitute: true },
] as const

// Python string.Template grammar: $$ escape, $identifier, ${identifier}, or a bare $ (invalid).
const PLACEHOLDER = /\$(?:(\$)|([_a-z][_a-z0-9]*)|\{([_a-z][_a-z0-9]*)\}|())/gi

type ProjectOptions = {
  readonly name: string
  readonly path: string
  readonly module: string
  readonly purpose: string
}

type Cli =
  | { readonly kind: "run"; readonly options: ProjectOptions }
  | { readonly kind: "help" }
  | { readonly kind: "usage"; readonly problem: string }

class ScaffoldError extends Error {
  constructor(
    readonly kind: "exists" | "template",
    message: string,
  ) {
    super(message)
    this.name = "ScaffoldError"
  }
}

function parseCli(): Cli {
  try {
    const { values, positionals } = parseArgs({
      args: Bun.argv.slice(2),
      options: {
        path: { type: "string", default: "." },
        module: { type: "string", default: "" },
        purpose: { type: "string", default: "HTTP" },
        help: { type: "boolean", short: "h", default: false },
      },
      allowPositionals: true,
      strict: true,
    })
    if (values.help) return { kind: "help" }
    const [name, ...extra] = positionals
    if (name === undefined || extra.length > 0) return { kind: "usage", problem: "expected exactly one project name" }
    const options = { name, path: values.path, module: values.module || name, purpose: values.purpose }
    return { kind: "run", options }
  } catch (error) {
    if (error instanceof TypeError) return { kind: "usage", problem: error.message }
    throw error
  }
}

function substitute(template: string, file: string, values: ReadonlyMap<string, string>): string {
  return template.replace(
    PLACEHOLDER,
    (match: string, escaped: string | undefined, named: string | undefined, braced: string | undefined) => {
      if (escaped !== undefined) return "$"
      const key = named ?? braced
      if (key === undefined) throw new ScaffoldError("template", `${file}: invalid placeholder near "${match}"`)
      const value = values.get(key)
      if (value === undefined) throw new ScaffoldError("template", `${file}: unknown placeholder $${key}`)
      return value
    },
  )
}

function initGoModule(projectDir: string, module: string): void {
  const init = runTool("go", ["mod", "init", module], projectDir)
  switch (init.kind) {
    case "ok":
      console.error(`  ran go mod init ${module}`)
      return
    case "unavailable":
    case "failed": {
      const detail = init.kind === "unavailable" ? init.reason : `exit ${init.status}: ${init.stderr.trim()}`
      console.error(`  warn go mod init failed (${detail}); writing fallback go.mod`)
      writeFileSync(join(projectDir, "go.mod"), `module ${module}\n\ngo 1.23\n`)
      return
    }
    default:
      return assertNever(init)
  }
}

function writeFiles(projectDir: string, { name, module, purpose }: ProjectOptions): void {
  const values = new Map([
    ["name", name],
    ["module", module],
    ["short_purpose", purpose],
  ])
  for (const { template, output, substitute: render } of FILES) {
    // The generated project is LF (its .editorconfig says end_of_line = lf); a CRLF checkout of the templates must not leak in.
    const raw = readFileSync(join(TEMPLATES_DIR, template), "utf8").replace(/\r\n/g, "\n")
    const outPath = join(projectDir, output)
    mkdirSync(dirname(outPath), { recursive: true })
    writeFileSync(outPath, render ? substitute(raw, template, values) : raw)
    console.error(`  wrote ${output}`)
  }
}

function scaffold(options: ProjectOptions): void {
  const projectDir = join(options.path, options.name)
  if (existsSync(projectDir)) throw new ScaffoldError("exists", `✗ ${projectDir} already exists`)

  mkdirSync(projectDir, { recursive: true })
  for (const dir of LAYOUT) mkdirSync(join(projectDir, dir), { recursive: true })
  initGoModule(projectDir, options.module)
  writeFiles(projectDir, options)

  console.error(`\nDone! cd ${projectDir}`)
  console.error("  go get github.com/caarlos0/env/v11")
  console.error("  task        # fmt + lint + test")
}

function main(): number {
  const cli = parseCli()
  switch (cli.kind) {
    case "help":
      console.log(USAGE)
      return 0
    case "usage":
      console.error(`Error: ${cli.problem}\n\n${USAGE}`)
      return 2
    case "run":
      break
    default:
      return assertNever(cli)
  }
  try {
    scaffold(cli.options)
    return 0
  } catch (error) {
    if (error instanceof ScaffoldError) {
      console.error(error.message)
      return 1
    }
    throw error
  }
}

process.exit(main())
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall