bostonaholic/skills

writing-system-prompts

Writes and reviews system prompts for AI tools, agents, chatbots, and LLM products using a fixed section order and a quality checklist.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/bostonaholic/skills --skill writing-system-prompts

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

System Prompt Engineering

Structure beats cleverness. Concrete examples beat abstract instructions.

A system prompt is a contract with the model. Every line must change its behavior in a way someone could test; cut the rest, including anything the model or its harness already does by default.

Section order

Follow this order and skip sections that don't apply. Read section guidance for each section's rules and good and bad examples.

text
1. Identity and role
2. Mission and stop criteria
3. Communication style
4. Core workflow
5. Tool usage rules
6. Domain-specific rules
7. Safety and constraints
8. Edge cases and error handling
9. Examples
10. Runtime context (injected at run time)

What a good prompt has

  • A specific role, not "AI assistant".
  • Explicit completion criteria: when to stop, and when to ask instead.
  • Response length capped with a number ("fewer than 4 lines"), never an

adjective ("be concise").

  • A retry limit with an escalation path for agents.
  • Constraints on security-critical and destructive actions, each with its

reason, stated once.

  • 3-10 concrete examples showing length and tone, tool-call decisions, and edge

cases, with at least one bad-to-good pair. Examples are the highest-return part of the prompt.

  • A runtime context section for values that change per session.

Write

Infer what the conversation and supplied files already answer. Ask only the rest, in one message, and wait: what the AI does, who its user is, which tools it has, what "done" looks like, what must never happen, and the expected output format. Deliver the prompt in a fenced block, followed by one line per assumption you made.

Review

Map the prompt to the section order, noting missing and misplaced sections. Flag each review anti-pattern present. Then revise. Unless the user asked for another format, report:

`markdown
## Findings

| Section | Issue | Fix |
| ------- | ----- | --- |

## Revised prompt

<the full revised prompt>

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills
bostonaholic
コミュニティ

auditing-complexity

Ranks where code complexity concentrates in a git repository (cyclomatic complexity, nesting, fan-out, mutable state) and scores CRAP change risk from a coverage file. Read-only. Use when asked for complexity hotspots or change risk. Not for test value; use auditing-tests.

1時間の導入数
1
GitHub Stars
2
更新日
10月20日
bostonaholic
コミュニティ

composing-agent-prompts

Composes a self-contained, source-cited task prompt for another coding agent to execute in a target repository, without running the task. Use when the user asks to write, draft, or hand off a prompt, brief, or task spec for another agent. Not for system prompts; use writing-system-prompts.

1時間の導入数
1
GitHub Stars
2
更新日
10月20日
bostonaholic
コミュニティ

conducting-deep-research

Conducts source-backed, goal-directed research that combines a scholarly evidence review with an institution, company, or funding map. Use when a request needs both an evidence review and an organization or funding map. Not for quick lookups or general research write-ups.

1時間の導入数
1
GitHub Stars
2
更新日
10月20日
bostonaholic
コミュニティ

cutting-skills

Audits or trims an existing agent skill to its behavioral core and narrows over-broad trigger metadata. Use when the user asks to cut, simplify, shorten, de-slop, or reduce the context cost or trigger aggressiveness of a SKILL.md or skill folder. Never infer from a skill being long or edited for another purpose.

1時間の導入数
1
GitHub Stars
2
更新日
10月20日