Senior QA
nicepkg/auto-company
Comprehensive QA and testing skill for quality assurance, test automation, and testing strategies for ReactJS, NextJS, NodeJS applications.
Project architecture, core services, key directories, data flow, and tech stack for the kouchou-ai repository.
Install Kouchou AI Architecture
$ npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digitaldemocracy2030/kouchou-ai kouchou-ai-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/digitaldemocracy2030/kouchou-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kouchou-ai-architecture .claude/skills/kouchou-ai-architecture && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "kouchou-ai-architecture" agent skill from https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architecture into .claude/skills/kouchou-ai-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kouchou-ai-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digitaldemocracy2030/kouchou-ai kouchou-ai-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digitaldemocracy2030/kouchou-ai.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/kouchou-ai-architecture .agents/skills/kouchou-ai-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "kouchou-ai-architecture" agent skill from https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architecture into .agents/skills/kouchou-ai-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kouchou-ai-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digitaldemocracy2030/kouchou-ai kouchou-ai-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digitaldemocracy2030/kouchou-ai.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/kouchou-ai-architecture .cursor/skills/kouchou-ai-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "kouchou-ai-architecture" agent skill from https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architecture into .cursor/skills/kouchou-ai-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kouchou-ai-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/digitaldemocracy2030/kouchou-ai.git --path skills/kouchou-ai-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digitaldemocracy2030/kouchou-ai kouchou-ai-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digitaldemocracy2030/kouchou-ai.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/kouchou-ai-architecture .gemini/skills/kouchou-ai-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "kouchou-ai-architecture" agent skill from https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architecture into .gemini/skills/kouchou-ai-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kouchou-ai-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install digitaldemocracy2030/kouchou-ai kouchou-ai-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/digitaldemocracy2030/kouchou-ai.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/kouchou-ai-architecture .github/skills/kouchou-ai-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "kouchou-ai-architecture" agent skill from https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architecture into .github/skills/kouchou-ai-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kouchou-ai-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install digitaldemocracy2030/kouchou-ai kouchou-ai-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digitaldemocracy2030/kouchou-ai.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/kouchou-ai-architecture .opencode/skills/kouchou-ai-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "kouchou-ai-architecture" agent skill from https://github.com/digitaldemocracy2030/kouchou-ai/tree/main/skills/kouchou-ai-architecture into .opencode/skills/kouchou-ai-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kouchou-ai-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
kouchou-ai-architecture- GitHub stars
- 171
- Token cost
- ~720 tokens
- SKILL.md length
- 309 words
- Files
- 1
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Project architecture, core services, key directories, data flow, and tech stack for the kouchou-ai repository.
- You need an overview of components
- SKILL.md covers Overview, Core services and ports, Key directories and Pipeline architecture and…, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Pipeline structure
What it does
Kouchou AI Architecture is an agent skill from digitaldemocracy2030/kouchou-ai. Project architecture, core services, key directories, data flow, and tech stack for the kouchou-ai repository. Use when you need an overview of components, pipeline structure, or where code lives.
Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Testing & QA. It works with Next.js. The repository describes itself as: 広聴AI (デジタル民主主義2030ブロードリスニング). The licence is AGPL-3.0.
When your agent uses it
- You need an overview of components
- Pipeline structure
- Where code lives
Example prompts
- “/kouchou-ai-architecture”
What it can do on your machine
Read from SKILL.md and the folder at commit c297bc9. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Kouchou AI Architecture loads about 720 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 309 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from digitaldemocracy2030/kouchou-ai at commit c297bc9, republished under its AGPL-3.0 licence (© digitaldemocracy2030). 309 words, ~720 tokens.
Download SKILL.mdSave it as
.claude/skills/kouchou-ai-architecture/SKILL.md (or your agent's skills folder).- name
- kouchou-ai-architecture
- description
- Project architecture, core services, key directories, data flow, and tech stack for the kouchou-ai repository. Use when you need an overview of components, pipeline structure, or where code lives.
Kouchou-AI Architecture
Overview
Use this skill to orient yourself in the repo and explain how the system fits together. Remember that Kouchou-AI is a broadlistening system for the Digital Democracy 2030 project, adapted from Talk to the City for Japanese municipal use cases.
Core services and ports
- Locate the API (FastAPI) in
apps/api/and expect it on port 8000. - Locate the public viewer (Next.js) in
apps/public-viewer/and expect it on port 3000. - Locate the admin app (Next.js) in
apps/admin/and expect it on port 4000. - Locate the static site builder in
apps/static-site-builder/and expect it on port 3200. - Expect the optional Ollama service on port 11434 for local LLM usage.
- Expect Ollama to use the ELYZA-JP model by default.
Key directories
- Use
packages/analysis-core/src/analysis_core/for analysis steps, orchestration, services, and workflows. - Use
apps/api/broadlistening/pipeline/for runtime configs, inputs, and outputs managed by the API. - Use
apps/public-viewer/components/charts/andapps/public-viewer/components/report/for report UI and charts. - Use
apps/admin/app/create/andapps/admin/app/create/hooks/for report creation UI. - Use
apps/api/src/routers/,apps/api/src/services/,apps/api/src/schemas/, andapps/api/src/repositories/for API layers.
Pipeline architecture and report flow
- Follow the flow: CSV upload -> API validation -> pipeline run -> hierarchical output -> public viewer.
- Start API-side orchestration at
apps/api/src/services/report_launcher.py. - Start CLI-side orchestration at
packages/analysis-core/src/analysis_core/__main__.pyandpackages/analysis-core/src/analysis_core/orchestrator.py. - Expect API-managed outputs under
apps/api/broadlistening/pipeline/outputs/{report_id}/.
Technology stack
- Treat the backend as FastAPI + OpenAI GPT models + sentence-transformers + pandas/numpy/scipy.
- Treat the frontend as Next.js 15 + TypeScript + Chakra UI + Plotly.js.
- Use pytest, Jest, and Playwright for testing.
- Use Biome (frontend) and Ruff (backend) for linting and formatting.
- Expect Azure Blob Storage support for storage needs.
- Use Lefthook for Git hooks (pre-push) as configured in
lefthook.yml.
Configuration pointers
- Check
biome.json,apps/api/pyproject.toml,lefthook.yml, and.env.examplefor core config.
Operational notes
- Require an OpenAI API key or local LLM for full pipeline runs.
- Validate LLM output for bias before acting on results.
- Back up report data before upgrading or applying breaking changes.
- Expect breaking changes between versions.
© digitaldemocracy2030, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/kouchou-ai-architecture of digitaldemocracy2030/kouchou-ai.
Open the folder on GitHubat commit c297bc9
Compare with similar skills
Kouchou AI Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Kouchou AI Architecture this skilldigitaldemocracy2030/kouchou-ai | 171 | — | ~720 | Automated safety check: Pass | AGPL-3.0 | |
| Senior QAnicepkg/auto-company | 195 | 3 repos | ~1.1k | Automated safety check: Notes | None | |
| Next Cache Components Optimizersanity-io/ui | 176 | 6 repos | ~6.3k | Automated safety check: Pass | MIT | |
| Playwright Coretestdino-hq/playwright-skill | 390 | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| Frontend Verifyucsandman/marketing-studio | 251 | — | ~2.4k | Automated safety check: Pass | MIT | |
| Testingtrieb-work/nextjs-turbo-redis-cache | 151 | — | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
- Official
Next Cache Components Optimizer
sanity-io/ui
Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components / PPR, on initial load (hard navigation) and client-side navigation (soft navigation).
Playwright Core
testdino-hq/playwright-skill
Battle-tested Playwright patterns for writing and debugging reliable E2E, API, component, visual, accessibility, and security tests.
Frontend Verify
ucsandman/marketing-studio
Verify frontend changes end to end after editing a web app, instead of manually clicking through pages.
Testing
trieb-work/nextjs-turbo-redis-cache
Run tests and add Next.js version coverage for the cache handler.
Javascript Testing Expert
softmaple/softmaple
Expert-level JavaScript testing skill focused on writing high-quality tests that find bugs, serve as documentation, and prevent regressions.
More from digitaldemocracy2030/kouchou-ai
Kouchou AI Development
digitaldemocracy2030/kouchou-ai
Local development setup, build and lint commands, environment configuration, and deployment helpers for the kouchou-ai repo.
Kouchou AI Testing
digitaldemocracy2030/kouchou-ai
Testing commands and strategy for the kouchou-ai repo, including unit/integration tests and Playwright E2E rules.
Related
Works with
Categories
Questions about Kouchou AI Architecture
What does Kouchou AI Architecture do?
Project architecture, core services, key directories, data flow, and tech stack for the kouchou-ai repository. Kouchou AI Architecture is an agent skill from digitaldemocracy2030/kouchou-ai. Project architecture, core services, key directories, data flow, and tech stack for the kouchou-ai repository.
When should I use Kouchou AI Architecture?
Kouchou AI Architecture fits situations like: you need an overview of components; pipeline structure; where code lives.
How do I install Kouchou AI Architecture in Claude Code?
Run `npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a claude-code`. Or copy the skill folder (skills/kouchou-ai-architecture in digitaldemocracy2030/kouchou-ai) into .claude/skills/kouchou-ai-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Kouchou AI Architecture in Codex?
Run `npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a codex`. Or copy the skill folder (skills/kouchou-ai-architecture in digitaldemocracy2030/kouchou-ai) into .agents/skills/kouchou-ai-architecture in your project. Codex loads it when a task matches its description.
Can I use Kouchou AI Architecture in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add digitaldemocracy2030/kouchou-ai --skill kouchou-ai-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kouchou-ai-architecture, .gemini/skills/kouchou-ai-architecture, .github/skills/kouchou-ai-architecture and .opencode/skills/kouchou-ai-architecture in your project.
What does Kouchou AI Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Kouchou AI Architecture is instructions for the agent only.
Does Kouchou AI Architecture access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Kouchou AI Architecture safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Kouchou AI Architecture use?
Kouchou AI Architecture is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Kouchou AI Architecture use?
About 720 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Kouchou AI Architecture?
Skills that share tags, products or a category with Kouchou AI Architecture: Senior QA (nicepkg/auto-company, 195 stars), Next Cache Components Optimizer (sanity-io/ui, 176 stars), Playwright Core (testdino-hq/playwright-skill, 390 stars) and Frontend Verify (ucsandman/marketing-studio, 251 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Kouchou AI Architecture?
digitaldemocracy2030 (a GitHub organization) maintains it in digitaldemocracy2030/kouchou-ai, which has 171 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 10, 2026.
Source: digitaldemocracy2030/kouchou-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.