semantic-generation

Generates referent tables before writing design documents, reports, and code identifiers.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/Kotomiya07/skills --skill semantic-generation-kotomiya07
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-generation
Source: https://github.com/Kotomiya07/skills/tree/main/plugins/semantic-generation/skills/semantic-generation
Command: npx skills add https://github.com/Kotomiya07/skills --skill semantic-generation-kotomiya07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When writing design documents, investigation reports, or naming code identifiers, vague ad-hoc coinages often appear before the underlying referent is fixed, causing drift between the intended subject and the words used. This Skill enforces a workflow where a referent table (correspondence table) is produced as an independent artifact before any prose is written, so terms are grounded in explicit referents and roles. ## Core Features & Use Cases - Referent-table-first workflow: Saves a standalone referent-table-<slug>.md file with a SHA-256 record before writing any body text, proving the table preceded the document. - Fixed seven-column schema: Columns for source, purpose, concrete referent, role (start condition / state / event / value / record / goal / means), reasoning order, candidate term, and first-use definition, with candidate terms locked to the rightmost column. - Three-layer consistency: Keeps Japanese prose, design elements, and code identifiers (state names, condition names, method names, type names) mapped to the same referents. - Use Case: When asked to write a design document or name states and methods for a feature, first produce the referent table mapping each concept to its role, then write the document using only the terms registered in that table. ## Quick Start Ask the AI to write a design document or name states and methods for your feature, and it will first save a referent table as an independent file before drafting the body text.

Frequently Asked Questions about semantic-generation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write design documents without ambiguous coined terms?

Create a referent table as an independent file before writing any body text. Fill in the concrete referent and role columns first, keep the candidate-term column empty until those are fixed, then write the document using only terms registered in the table.

What is a referent table and what columns does it need?

A referent table maps each term to its source, purpose, concrete referent, role, reasoning order, candidate term, and first-use definition. Roles are chosen from a closed set: start condition, state, event, value, record, goal, or means.

When should this naming and generation procedure be used?

Use it when writing design documents, investigation reports, or countermeasure proposals, when naming states, conditions, types, methods, or booleans, or when summarizing a user's reasoning order into short labels. It does not apply to quoting user text, mechanical edits, or short text using established terminology.

What should I do if body text was written before the referent table?

Discard the body text rather than appending a table retroactively. Save the referent table as an independent artifact first, then regenerate the body from it, since a table added afterward does not prove correct generation order.

Can this procedure work in environments where the skill is unavailable?

Yes. As a fallback, save a table with at least six columns (source, purpose, concrete referent, role, reasoning order, candidate term) as an independent file in the working directory before starting the body text.