Skip to content

mtk177a/mtk177a-skills

v0.1.0MIT

Reusable skills for clarifying requests, writing, making decisions, and developing software.

skills

A personal collection of agent Skills authored or maintained by mtk177a, plus two designated unmodified Gist mirrors.

The Skills follow the Agent Skills specification.
Whether a Skill works also depends on the client, and on what the agent can access and do.
Check the runtime requirements before installation.

No warranty: The owner maintains this personal repository on a best-effort basis.
The owner can change or remove Skills without notice.
Use at your own risk.

Install

There are two installation methods, and both install the same Skills from skills/:

  • Plugin ZIP: the only method for ChatGPT.
    A plugin uploaded to ChatGPT is also available in Codex.
  • APM: for Claude Code, Codex, Cursor, and the other clients that APM supports.

To choose a method and install, see Install and update the Skills.

Skills

Choose a Skill by task.
Then read the linked Skill to see when to use it and what it produces.
To use several Skills on one piece of work, see Choose the next Skill.

Clarify and choose an approach

TaskSkill
Clarify an ambiguous requestclarify-request
Define what ambiguous terms refer todefine-referents
Compare different problem frames and solutionsexplore-decision-space
Choose an AI execution environment for the taskchoose-ai-execution-setup
Preserve understanding and decision ownership while using AIcalibrate-learning-support

Design, implement, and investigate

TaskSkill
Plan scope, risks, and verification before implementationdesign-changes
Implement an authorized change and verify itimplement-changes
Investigate unexpected behavior and failuresinvestigate-failure
Assess safety, recovery, and authorization before a consequential actionassess-risky-change-readiness
Stop repeated failed attempts and choose the next diagnostic stepbreak-failure-loop

Review and communicate changes

TaskSkill
Review a new diff, or re-review the whole diff when explicitly requestedreview-changes
Assess findings and decide how to respondtriage-review-feedback
Recheck identified fixes against their original findingsvalidate-fix
Draft PR comments from supplied review decisionsdraft-review-comments
Draft an Issue without posting itdraft-issue
Plan commit units and draft their messagesdraft-commit
Summarize a diff or commit range for its readerssummarize-changes
Record evidence for resuming work in another sessionrecord-session-handoff

Research and write

TaskSkill
Research the Web with traceable evidenceresearch-web-safely
Select and organize information for the readerstructure-what-you-write
Explain an answer and the reasoning needed to understand itmake-it-click
Write and revise natural Japanese without changing meaningwrite-natural-japanese
Apply Japanese technical-writing rulesjapanese-tech-writing
Design pacing in explanatory Japanese prosecognitive-rhythm-writing
Have an authorized independent subagent revise a documentrevise-docs-fresh-eyes

Maintain Skills and agent instructions

TaskSkill
Diagnose gaps between agent guidance and behavioraudit-agent-guidance
Design a Skill’s responsibility and boundariesdesign-skill
Design instruction files and client loading relationshipsdesign-agent-instructions

japanese-tech-writing and cognitive-rhythm-writing are unmodified copies of upstream Gists.
Their source revisions, licenses, and synchronization records are in each Skill's UPSTREAM.md and THIRD_PARTY_NOTICES.md.

Maintain

TaskGuide
Verify changes and prepare Issues, commits, and pull requestsContributing
Author a SkillSkill authoring guide
Build the plugin ZIPBuild the plugin ZIP
Review third-party material and executable capabilitiesSkill security review
Choose the language and maintain Japanese reference translationsLanguages and Japanese reference translations
Check the terms used for repository conceptsGlossary

External contributions are not normally expected.

License

Original code and content are licensed under the MIT License.
Third-party material retains the terms listed in THIRD_PARTY_NOTICES.md.

Copyright (c) 2026 mtk177a