https://github.com/kongyo2/agent-primary-ts-starters-src
https://github.com/kongyo2/agent-primary-ts-starters-src
agent-skills claude-code
Last synced: 28 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/kongyo2/agent-primary-ts-starters-src
- Owner: kongyo2
- License: mit
- Created: 2026-05-24T03:12:30.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-24T04:55:12.000Z (about 1 month ago)
- Last Synced: 2026-05-24T06:29:46.962Z (about 1 month ago)
- Topics: agent-skills, claude-code
- Language: TypeScript
- Homepage:
- Size: 145 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @kongyo2/apts
> Agent-Primary TypeScript Starters — a CLI that lets coding agents `search` and `retrieve` the [agent-primary-ts-starters](https://github.com/kongyo2/agent-primary-ts-starters) skill guides on demand.
`apts` wraps four agent-friendly TypeScript starters (tsconfig, Prettier, Oxlint, Zod) behind a semantic-search interface. Use it as a one-shot CLI so coding agents pull the right guidance into context automatically.
## Quickstart
```shell
# Search for relevant skills
npx @kongyo2/apts@latest search "set up strict tsconfig for an LLM agent loop"
# Retrieve a guide by ID
npx @kongyo2/apts@latest retrieve "ts-tsconfig-modern-strict-starter"
# List every available skill
npx @kongyo2/apts@latest list
```
## CLI reference
### `apts search [flags]`
Semantic search over the skill catalog. Returns a JSON array sorted by cosine similarity.
| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--limit ` | int > 0 | `5` | Maximum number of results. |
| `--threshold <0.0-1.0>` | float | `0.0` | Minimum similarity to include. |
| `--format ` | `json` \| `text` | `json` | `text` emits one-line human-readable rows. |
```shell
# Take only the single best match
npx @kongyo2/apts@latest search "lint TypeScript without stylistic noise" --limit 1
# Drop weak matches
npx @kongyo2/apts@latest search "runtime validation" --threshold 0.4
# Human-readable output for eyeballing
npx @kongyo2/apts@latest search "format diff-friendly" --format text
```
### `apts retrieve [flags]`
Pull one or more SKILL.md files by ID. Comma-separated IDs are supported.
| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--format ` | `markdown` \| `json` | `markdown` | `json` returns `[{ id, frontmatter, content, … }]`. |
```shell
# Default: raw markdown, ready to inline into agent context
npx @kongyo2/apts@latest retrieve ts-npm-prettier-starter
# Structured for programmatic consumers
npx @kongyo2/apts@latest retrieve ts-npm-prettier-starter,ts-npm-oxlint-starter --format json
```
### `apts list`
Print the full catalog as JSON: `{ id, category, description, tokenCount }`.
## License
MIT. Skill content under `skills/` is mirrored from [agent-primary-ts-starters](https://github.com/kongyo2/agent-primary-ts-starters).