code-yeongyu/oh-my-openagent / packages/shared-skills/skills/programming
programming
UnverifiedApplies 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.
scripts/python/new-script.ts
View on GitHub#!/usr/bin/env bun
/**
* Generate a PEP 723 Python script with all boilerplate pre-filled: uv shebang,
* inline metadata (requires-python + dependencies), the mandatory "How to run"
* block, `from __future__ import annotations`, and a main() guard.
*
* ─── How to run ───
* 1. Install Bun: curl -fsSL https://bun.sh/install | bash
* 2. Run:
* bun run new-script.ts my_tool
* bun run new-script.ts my_tool --output ./scripts/my_tool.py
* bun run new-script.ts my_tool --deps 'httpx2[http2,brotli,zstd]' --deps rich --deps polars
* bun run new-script.ts my_tool --py 3.13
* ──────────────────
*
* Writes to <os tmpdir>/uv-scripts/<name>.py unless --output is given.
* Exit codes: 0 written, 2 usage error.
*/
import { chmodSync, mkdirSync, statSync, writeFileSync } from "node:fs"
import { tmpdir } from "node:os"
import { dirname, join } from "node:path"
import { parseArgs } from "node:util"
import { assertNever } from "../shared/run-tool.ts"
const USAGE = `Usage: bun run new-script.ts <name> [--output <path>] [--deps <dep>]... [--py <version>]
Arguments:
name Script name (without .py extension)
Options:
-o, --output Output path (default: OS temp directory)
-d, --deps Dependency to include (repeat --deps for each)
--py Minimum Python version (default: 3.13)
-h, --help Show this help`
type ScriptOptions = {
readonly name: string
readonly output: string | undefined
readonly deps: readonly string[]
readonly py: string
}
type Cli =
| { readonly kind: "run"; readonly options: ScriptOptions }
| { readonly kind: "help" }
| { readonly kind: "usage"; readonly problem: string }
function parseCli(): Cli {
try {
const { values, positionals } = parseArgs({
args: Bun.argv.slice(2),
options: {
output: { type: "string", short: "o" },
deps: { type: "string", short: "d", multiple: true, default: [] },
py: { type: "string", default: "3.13" },
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 script name" }
return { kind: "run", options: { name, output: values.output, deps: values.deps, py: values.py } }
} catch (error) {
if (error instanceof TypeError) return { kind: "usage", problem: error.message }
throw error
}
}
function renderScript(pythonVersion: string, deps: readonly string[], filename: string): string {
const depsBlock =
deps.length > 0
? deps.map((dep) => `# "${dep}",\n`).join("")
: '# # add deps here, e.g.: "httpx2[http2,brotli,zstd]"\n'
const argsHint = ""
return `#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=${pythonVersion}"
# dependencies = [
${depsBlock}# ]
# ///
# ─── How to run ───
# 1. Install uv (if not installed):
# curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. Run directly (no venv, no pip install needed):
# uv run ${filename} ${argsHint}
# 3. Or make executable and run:
# chmod +x ${filename} && ./${filename}
# ──────────────────
from __future__ import annotations
def main() -> None:
"""TODO: implement."""
if __name__ == "__main__":
main()
`
}
function writeScript({ name, output, deps, py }: ScriptOptions): void {
const filename = name.endsWith(".py") ? name : `${name}.py`
const dest = output ?? join(tmpdir(), "uv-scripts", filename)
mkdirSync(dirname(dest), { recursive: true })
writeFileSync(dest, renderScript(py, deps, filename))
if (process.platform !== "win32") chmodSync(dest, statSync(dest).mode | 0o111)
console.log(`✓ Created: ${dest}`)
console.log(` Run: uv run ${dest}`)
}
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":
writeScript(cli.options)
return 0
default:
return assertNever(cli)
}
}
process.exit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |