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.