# Efficient Coding

> A curated collection of reusable AI coding skills, MCP server configs, and engineering playbooks for faster, more systematic software development.

- **Type:** MCP server
- **Install:** `agentstack add mcp-jtsang4-efficient-coding`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jtsang4](https://agentstack.voostack.com/s/jtsang4)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jtsang4](https://github.com/jtsang4)
- **Source:** https://github.com/jtsang4/efficient-coding

## Install

```sh
agentstack add mcp-jtsang4-efficient-coding
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Efficient Coding

English | [中文](README_ZH.md)

This repo contains:
- Optional MCP server configuration.
- Reusable agent skills/playbooks you can install via `bunx skills add`.

## MCP Servers

| Server | Purpose | Transport | Command | Source |
| --- | --- | --- | --- | --- |
| fetcher (fetcher-mcp) | Fetch web page content using a Playwright headless browser. | stdio | `bunx -y fetcher-mcp` | https://www.npmjs.com/package/fetcher-mcp |

To use an MCP server, add it to your coding agent’s MCP configuration. A generic example config lives at `.mcp.json`.

## Skills

Skills are reusable capability/workflow/methodology playbooks you can invoke to approach a task (e.g. planning, debugging, TDD).

| Skill | Category | When to use |
| --- | --- | --- |
| [`brainstorming`](skills/brainstorming/SKILL.md) | Workflow | New feature / unclear requirements; produce a design/spec first. |
| [`codex-skill-creator`](skills/codex-skill-creator/SKILL.md) | Meta | Create, improve, benchmark, review, and package Codex skills, including paired eval runs and `eval-viewer/generate_review.py` review loops. |
| [`cubox-research`](skills/cubox-research/SKILL.md) | Research | Search a user's Cubox collection deeply by topic, vary keywords intentionally, fetch strong article matches, and analyze exported Markdown locally. Requires Bun and a configured `.env`. |
| [`harness`](skills/harness/SKILL.md) | Workflow | Transform any code project into one optimized for AI agent collaboration through harness engineering. Scans codebase, extracts engineering knowledge, and generates structured context documents. |
| [`memos`](skills/memos/SKILL.md) | Integration | Work with the Memos REST API for memos, attachments, and activities: create/read/query/update/delete memos, manage comments/reactions/relations/attachments, and inspect activities. Requires Bun and a configured `.env`. |
| [`dev-browser`](skills/dev-browser/SKILL.md) | Automation | Browser/web automation: navigate pages, click/fill forms, take screenshots, scrape data, or test authenticated flows. |
| [`exa-web-search`](skills/exa-web-search/SKILL.md) | Research | Free AI web/code/company search via Exa MCP (no API key) when you need current information or code examples. |
| [`readwise-research`](skills/readwise-research/SKILL.md) | Research | Build a topic memo from the user's Readwise/Reader documents and highlights, then suggest shortlist/tag/archive actions before any mutation. |
| [`see`](skills/see/SKILL.md) | Integration | Integrate with S.EE APIs for short URLs, text sharing, and file sharing. |
| [`shape`](skills/shape/SKILL.md) | Product | Shape fuzzy ideas into clear product decisions and SPEC docs before coding. |
| [`impeccable` (external bookmark)](https://github.com/pbakaus/impeccable) | Reference (External) | Frontend design reference bundle (`frontend-design` skill + 17 commands + anti-patterns) for critique, polish, motion, color, and responsive refinement; bookmark only (not included locally in this repo). |
| [`ui-ux-pro-max-skill` (external bookmark)](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) | Reference (External) | UI/UX prompts/workflows reference; bookmark only (not included locally in this repo). |
| [`systematic-debugging`](skills/systematic-debugging/SKILL.md) | Workflow | Bugs, flakes, or “unexpected behavior”; find root cause before fixing. |
| [`writing-plans`](skills/writing-plans/SKILL.md) | Workflow | Approach is decided; turn it into an executable plan with steps + verification. |
| [`executing-plans`](skills/executing-plans/SKILL.md) | Execution | Run a written plan in small batches with review checkpoints. |
| [`subagent-driven-development`](skills/subagent-driven-development/SKILL.md) | Execution | Run a plan in-session: one subagent per task + spec/quality review loops. |
| [`test-driven-development`](skills/test-driven-development/SKILL.md) | Implementation | Any feature/bugfix/refactor: Red → Green → Refactor (no code without a failing test). |
| [`worktree-manager`](skills/worktree-manager/SKILL.md) | Workflow | Worktree management via Worktrunk (`wt`): switch/create/list/merge/remove with safety guardrails. |

### Install

- `bunx skills add http://github.com/jtsang4/efficient-coding --skill brainstorming`
- `bunx skills add http://github.com/jtsang4/efficient-coding --skill codex-skill-creator`
- `bunx skills add http://github.com/jtsang4/efficient-coding --skill memos`
- Template: `bunx skills add http://github.com/jtsang4/efficient-coding --skill `

### Use

- If you want a specific skill, say so explicitly (named skill wins).
- For creating a new skill, revising an existing one, improving trigger descriptions, or running a human-review eval loop for skills, use `codex-skill-creator`.
- If multiple skills apply, default to workflow first: `brainstorming`/`systematic-debugging` → `writing-plans` → execute (`executing-plans` | `subagent-driven-development`) → `test-driven-development` inside each task.
- For bugs: `systematic-debugging` → add a failing test → fix with `test-driven-development`.
- For browser interaction tasks (navigate/click/fill/screenshot/scrape), use `dev-browser`.
- For questions that should be answered from the user's Cubox library, use `cubox-research` first; it searches broadly, fetches the strongest article details, and stays read-only unless the user explicitly asks for a mutation.
- For Memos API tasks around memos, attachments, or activities, use `memos`; it provides a Bun CLI plus bundled API guidance and expects a local `.env` with `MEMOS_BASE_URL` and `MEMOS_ACCESS_TOKEN`.
- For web/code/company research tasks, use `exa-web-search`.
- For questions about what the user has already read, saved, or highlighted in Readwise/Reader, use `readwise-research` first; it treats the Readwise library as the source of truth and stays read-only until explicit confirmation.
- For frontend visual design, UI critique/polish, motion, color, or responsive refinement, keep [`impeccable`](https://github.com/pbakaus/impeccable) handy as an external design reference.

Skill sources (optional)

This table lists the source repositories for skills installed/updated from external repos. The Notes column summarizes local customizations in this repo (if any).

| Skill | Source repo | Notes |
| --- | --- | --- |
| `brainstorming` | [`obra/superpowers`](https://github.com/obra/superpowers) | Worktree ops are delegated to `worktree-manager` (copy current working state). |
| `systematic-debugging` | [`obra/superpowers`](https://github.com/obra/superpowers) | If you need a dedicated worktree to isolate a repro, use `worktree-manager`. |
| `writing-plans` | [`obra/superpowers`](https://github.com/obra/superpowers) | Worktree ops are delegated to `worktree-manager` (copy current working state). |
| `executing-plans` | [`obra/superpowers`](https://github.com/obra/superpowers) |  |
| `subagent-driven-development` | [`obra/superpowers`](https://github.com/obra/superpowers) |  |
| `test-driven-development` | [`obra/superpowers`](https://github.com/obra/superpowers) |  |

## Standards

These are the default engineering conventions recommended in this repo. The table stays flat on purpose so future specs can be added as new rows without changing the structure.

| Category | Applies to | Recommendation | Quick note | Reference |
| --- | --- | --- | --- | --- |
| Project layout | Go services/apps | [`golang-standards/project-layout`](https://github.com/golang-standards/project-layout) | Good default for larger Go codebases; common directories include `cmd`, `internal`, and `pkg`. Keep small projects simpler when the extra structure is unnecessary. |  |
| Project layout | Frontend applications | [Feature-Sliced Design (FSD)](https://fsd.how/docs/get-started/overview/) | Organize by layers and business slices (for example `app`, `pages`, `features`, `entities`, `shared`) so frontend code stays easier to scale and evolve. |  |
| Lint | Frontend / JS / TS | [Biome](https://biomejs.dev/linter/) | Unified formatter and linter for frontend projects with fast performance and sensible defaults; start with the recommended rules, then tighten conventions as needed. |  |
| i18n | React / frontend | [`react-i18next`](https://github.com/i18next/react-i18next) | Standard choice for React apps in the `i18next` ecosystem; supports hooks/components, namespaces, interpolation, and pluralization. |  |
| i18n | Go services/apps | [`go-i18n`](https://github.com/nicksnyder/go-i18n) | Use bundles plus locale files to manage translations in Go; supports plural forms, template variables, and CLI-based extract/merge workflows. |  |

## Scripts

| Script | Purpose | Usage |
| --- | --- | --- |
| [`install-autojump-rs.sh`](scripts/install-autojump-rs.sh) | One-click installer for `autojump-rs` on macOS/Linux with `bash`/`zsh`/`fish` integration and an uninstall mode. | `bash scripts/install-autojump-rs.sh` or `bash scripts/install-autojump-rs.sh --uninstall` |

## Config

Recommended repo configuration:

| Config | Files | What it does | Notes |
| --- | --- | --- | --- |
| Worktrunk “copy from base” hook | `.config/wt.toml`, `scripts/wt-copy-from-base` | When Worktrunk creates a new worktree, it copies the current workspace state from the base worktree into the new one (instead of a completely clean worktree). | Makes it easy to carry along git-ignored files like local dependencies, `.env`, caches, etc. Pairs well with the `worktree-manager` skill. |

## License

MIT. See [`LICENSE`](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jtsang4](https://github.com/jtsang4)
- **Source:** [jtsang4/efficient-coding](https://github.com/jtsang4/efficient-coding)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jtsang4-efficient-coding
- Seller: https://agentstack.voostack.com/s/jtsang4
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.