Agent skill

Urban Road Code Fundamentals

by h30190 in h30190/HJPLUS_Taiwan_Architect_KB

This skill should be used to establish which instrument and which version govern before applying any Taiwan Urban Road Design Code (市區道路及附屬工程設計規範) dimension: the standard-versus-code hierarchy, the…

CC-BY-SA-4.0Auto-check passedFrontend & Design

Install Urban Road Code Fundamentals

skills CLI
$ npx skills add h30190/HJPLUS_Taiwan_Architect_KB --skill urban-road-code-fundamentals -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install h30190/HJPLUS_Taiwan_Architect_KB urban-road-code-fundamentals --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/h30190/HJPLUS_Taiwan_Architect_KB.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'raw/公共工程/市區道路及附屬工程設計規範/urban-road-code-fundamentals' .claude/skills/urban-road-code-fundamentals && rm -rf skills-src

Use ~/.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/

Facts

Skill name
urban-road-code-fundamentals
GitHub stars
158
Token cost
~2.4k tokens
SKILL.md length
1,050 words
Files
4 (incl. references)
Skills in repo
86
Repo updated
First seen
Licence
CC-BY-SA-4.0

At a glance

This skill should be used to establish which instrument and which version govern before applying any Taiwan Urban Road Design Code (市區道路及附屬工程設計規範) dimension: the standard-versus-code hierarchy, the…

  • Tasks that involve Accessibility
  • SKILL.md covers Overview, Legal Hierarchy, Normative Language Rules and Jurisdiction: Is This an Urban…, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Urban Road Code Fundamentals is an agent skill from h30190/HJPLUS_Taiwan_Architect_KB. This skill should be used to establish which instrument and which version govern before applying any Taiwan Urban Road Design Code (市區道路及附屬工程設計規範) dimension: the standard-versus-code hierarchy, the 應/不得/宜/不宜 wording rules, the provincial-highway co-alignment rule, road classification and design speed, and the full chapter map. Invoke it when a reviewer cites 市區道路及附屬工程設計標準 or 設計規範 and it is unclear which applies, when a road section is shared with a highway, or as the shared basis before the…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/ch06-13-15-pedestrian-space.md`, `references/ch16-landscape-ecology.md` and `references/chapter-map.md`). Compatibility notes: claude-code,opencode,agent-skills

It sits in Frontend & Design, covering Accessibility. The repository describes itself as: 一個開源的台灣AEC產業知識庫,只要你願意共享經驗與知識就歡迎加入我們. The licence is CC-BY-SA-4.0.

When your agent uses it

  • Tasks that involve Accessibility

Example prompts

  • “/urban-road-code-fundamentals”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): claude-code,opencode,agent-skills

What it can do on your machine

Read from SKILL.md and the folder at commit 35ed06e. 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 (its code samples are python).

    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.

  • Compatibility

    claude-code,opencode,agent-skills

    From compatibility in the SKILL.md frontmatter.

Context cost

Urban Road Code Fundamentals loads about 2.4k tokens when it runs, and up to ~8.5k if it reads all its reference files. Until then it costs about 162 tokens; SKILL.md has 1,050 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~162
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.5k

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 h30190/HJPLUS_Taiwan_Architect_KB at commit 35ed06e, republished under its CC-BY-SA-4.0 licence (© h30190). 1,050 words, ~2,443 tokens.

Download SKILL.mdSave it as .claude/skills/urban-road-code-fundamentals/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
urban-road-code-fundamentals
description
This skill should be used to establish which instrument and which version govern before applying any Taiwan Urban Road Design Code (市區道路及附屬工程設計規範) dimension: the standard-versus-code hierarchy, the 應/不得/宜/不宜 wording rules, the provincial-highway co-alignment rule, road classification and design speed, and the full chapter map. Invoke it when a reviewer cites 市區道路及附屬工程設計標準 or 設計規範 and it is unclear which applies, when a road section is shared with a highway, or as the shared basis before the pedestrian-accessibility or landscape-planting skills. It does not carry the pedestrian or planting dimensions themselves.
compatibility
claude-code,opencode,agent-skills
type
Skill
license
CC-BY-SA-4.0
status
draft
metadata.audience
architects
metadata.region
taiwan
metadata.class
C
metadata.status
draft
metadata.data-currency
2026-08-15

Urban Road Design Code: Fundamentals

Overview

Taiwan regulates urban roads through a tiered instrument stack, and most wrong answers come not from misreading a clause but from applying the wrong instrument, the wrong version, or the wrong jurisdiction. This skill is the shared basis for every urban-road question: it settles which document governs before any dimension is quoted.

It carries the horizontal rules only. Pedestrian and accessibility dimensions live in urban-road-pedestrian-accessibility; planting and landscape dimensions in urban-road-landscape-planting. Both of those open by applying the rules defined here.

For an architect, the usual entry point is not designing a road but confirming that a building-side interface (sidewalk frontage, vehicle crossing, road-fronting planting) does not conflict with the code, or reading a civil consultant's drawings on a development that includes road works. This skill answers "which rule governs, and is this even an urban-road question."

TierInstrumentNatureBinding force
1市區道路條例 §32(1)Statute, delegating authorityBinding
2市區道路及附屬工程設計標準Regulation issued by MOI[^std-2021]Binding, directly enforceable
3市區道路及附屬工程設計規範Technical code issued under 設計標準 §29[^code-2026]Flexible, principle-based; values set at the lower bound of the applicable range

When Tier 2 and Tier 3 conflict on the same item, Tier 2 prevails. Flag the discrepancy rather than silently picking one. The known live example is the tree pit: 設計標準 §21(4) says pit area shall be 1.5 m² or more, while 設計規範 §16.2 says clear area shall exceed 1.5 m². The standard outranks the code.

For multi-regime conflicts beyond this code (fire, accessibility dual-track, national-versus-local), defer to the KB methodology skill regulation-hierarchy-and-conflicts.

Normative Language Rules

Appendix 4 item 1 defines the code's own modal vocabulary.[^code-2026] Apply it before quoting any value, in this skill or the two that build on it.

TermDefault positionExceptionHow to report it
應Must doNoneRequirement; cite the clause
不得Must not doNoneProhibition; cite the clause
宜Should do (default duty to comply)Deviation allowed with justified reasonRecommended, not mandatory; ask for the reason if deviated
不宜Should not do (default prohibition)Deviation allowed with justified reasonDiscouraged as a default ban, not a soft hint; the burden to justify is heavier than a plain 宜

The four terms are not two soft and two hard. The real split is whether an exception exists: 應/不得 have no exception; 宜/不宜 carry a default position that holds unless a justified reason is shown. Within that pair, 宜 and 不宜 are mirror images, not a positive-versus-negative suggestion: 宜 means do it by default, 不宜 means do not do it by default. Treat a 不宜 breach as a default prohibition the designer must actively justify, not merely as something "not encouraged".

"以上" and "以下" are inclusive of the stated number. Never convert a 宜 or 不宜 value into an ERROR-level finding: both keep the justified-reason opening, which is the difference from 應/不得. That is the single most common way an AI answer becomes indefensible in a design review.

Jurisdiction: Is This an Urban Road?

Urban roads sit under MOI (國土管理署); highways under MOTC (公路局). The two systems have different authorities, legal bases and dimensions, so the first question is always which system applies.

Co-alignment rule. Where an urban road runs shared with a provincial highway, the governing design standard is determined by 公路修建養護管理規則 §31 and 市區道路條例 §18, per Appendix 4 item 2.[^code-2026] Resolve jurisdiction with those two provisions before quoting any dimension. This is a determinate rule, not a judgement call.

Local variation. Appendix 5 lists Taipei's and Kaohsiung's own road design instruments as source literature, and the code allows competent authorities to issue their own manuals and standard drawings. A municipality may set stricter values. Confirm local rules before treating a national floor as the final answer.

Show full SKILL.md (428 more words)Show less

Road Classification and Cross-Section (Part 1)

Needed to pick the right value in the downstream skills, since several thresholds vary by road class.

  • Functional classes: expressway (快速道路), primary (主要道路), secondary (次要道路), service road (服務道路). Design speed and cross-section elements follow the class (§5, §7).
  • Cross-section is assembled from defined units: carriageway, shoulder, bicycle lane, sidewalk, traffic island, public utility strip, parking bay, drainage, underground ducts (§7).
  • Right-of-way may be widened beyond the running-lane need to provide space for stormwater retention, ecological corridors, school-zone walking, commercial activity, landmarks and landscape features (§7, planning principles).

Detailed geometric values (lane widths, sight distance, superelevation, vertical curves, intersections, bicycle facilities) are civil-engineering scope and are held at chapter level in references/chapter-map.md, not carried here.

Chapter Map

The code runs to three parts, twenty chapters and five appendices. Full map, plus chapter-level summaries for every chapter an architect does not routinely design but may need to read on a civil consultant's drawings (drainage, subgrade, pavement, bus stops, pedestrian bridges, traffic calming, bridges, tunnels, lighting, traffic devices, ducts), is in references/chapter-map.md.

Which skill owns what:

TopicOwning skill
Which instrument or version governs, wording, co-alignment, classificationthis skill
Sidewalk clear width, slope, vehicle crossings, public utility strip, accessibility, kerbsurban-road-pedestrian-accessibility
Tree pits, spacing, soil depth, species, sight-line planting, island planting, landscape/ecologyurban-road-landscape-planting
Geometry, drainage, structure, road furniture (reference only)references/chapter-map.md

Data Currency

  • Source: 市區道路及附屬工程設計規範, consolidated text as amended 2026-04-23; 市區道路及附屬工程 設計標準 §2, §16, §21, §29, as amended 2021-08-11
  • Verified: 2026-08-15, by clause-by-clause comparison against the consolidated code text and the Ministry of Justice law database entry for the regulation
  • Code amendment history: issued 1998-04-29 (台內營字第0980803106號); amended 2015-07-22 (台內營字第1040810606號); 2022-02-10 (台內營字第1100819869號); 2024-09-12 (台內國字第1130808877號); 2026-04-23
  • Volatility: MEDIUM to HIGH. Four amendments in twelve years, three since 2022.

To Verify

  • Add the MOI order number and official file URL for the 2026-04-23 amendment; the consolidated text was supplied by a contributor, and the agency listing consulted on 2026-08-15 still showed 2024-09-12 as the latest entry.
  • Add law database URLs for 市區道路條例 §18 and §32, and 公路修建養護管理規則 §31, to sources, so the co-alignment rule is independently traceable.
  • Confirm the current text of 設計標準 §16 and §29 against the law database; only §2 and §21 were checked directly.

MCP Tool Examples

python
# Confirm the delegating regulation
taiwan-building-code_search_building_code(query="市區道路及附屬工程設計標準 第29條 授權", limit=10)

# Resolve a co-aligned section before applying dimensions
taiwan-building-code_search_building_code(query="公路修建養護管理規則 第31條 市區道路條例 第18條")

Additional Resources

  • Human-facing overview in Traditional Chinese: domain.md

[^std-2021]: 市區道路及附屬工程設計標準, amended 2021-08-11. [^code-2026]: 市區道路及附屬工程設計規範, consolidated text as amended 2026-04-23, issued by the Ministry of the Interior.

© h30190, CC-BY-SA-4.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in raw/公共工程/市區道路及附屬工程設計規範/urban-road-code-fundamentals of h30190/HJPLUS_Taiwan_Architect_KB.

  • SKILL.md
  • references/ch06-13-15-pedestrian-space.md
  • references/ch16-landscape-ecology.md
  • references/chapter-map.md

Open the folder on GitHubat commit 35ed06e

Compare with similar skills

Urban Road Code Fundamentals 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.

Urban Road Code Fundamentals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Urban Road Code Fundamentals this skillh30190/HJPLUS_Taiwan_Architect_KB158—~2.4kAutomated safety check: PassCC-BY-SA-4.0
Web Interface Guidelines Reviewervercel-labs/openreview1.7k97 repos~308Automated safety check: PassNone
Accessibility Reviewmarkmead/hyperui12k1 repos~1.1kAutomated safety check: PassMIT
Web Animation DesignbaptisteArno/typebot.io11k2 repos~2.7kAutomated safety check: PassCustom licence
Accessibility Fixeribelick/ui-skills9.6k4 repos~1.2kAutomated safety check: PassMIT
Wcag Audit PatternsvmDeshpande/ai-agent-automation17811 repos~610Automated safety check: PassApache-2.0

Similar skills

  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 97 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Accessibility Review

    markmead/hyperui

    Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.

    12k GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Web Animation Design

    baptisteArno/typebot.io

    Guides easing, timing and animation choices for UI motion, based on a web animation course, and reviews existing animations in a before-and-after table.

    11k GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed
  • Accessibility Fixer

    ibelick/ui-skills

    Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.

    9.6k GitHub starsUsed in 4 repos~1.2k tokens
    Frontend & DesignAuto-check passed
  • Wcag Audit Patterns

    vmDeshpande/ai-agent-automation

    Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance.

    178 GitHub starsUsed in 11 repos~610 tokens
    Frontend & DesignAuto-check passed
  • Baseline UI

    ibelick/ui-skills

    Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.

    9.6k GitHub starsUsed in 8 repos~855 tokens
    Frontend & DesignAuto-check passed

More from h30190/HJPLUS_Taiwan_Architect_KB

All 86 skills in this repo
  • Green Material Search Toolkit

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when an architect or consultant needs to search Taiwan's TABC (財團法人臺灣建築中心) green building material certification database, assemble a set of qualified materials for a…

    158 GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed
  • Skill Name Hyphenated

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when [specific trigger scenarios].

    158 GitHub stars~791 tokensUpdated 3 days ago
    Auto-check passed
  • Taichung Land Parcel Query

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when an architect receives just an address or lot number (地號) for a site in Taichung City, Taiwan, and needs the land's basic data — zoning, registered land area, land…

    158 GitHub stars~1.9k tokensUpdated 3 days ago
    Auto-check passed
  • Permit Report Data Mapping

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when mapping a legacy CPAMI permit report identifier to its actual BMS data groups, computed display fields, or unresolved template dependencies.

    158 GitHub stars~1.4k tokensUpdated 3 days ago
    Auto-check passed
  • Revit AI Targeting And Safe Execution

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when an AI agent, MCP tool, Revit add-in, or automation must inspect or change a live Revit model and needs to prove its target set, choose bounded read-only context…

    158 GitHub stars~3.6k tokensUpdated 3 days ago
    Auto-check passed
  • Smoke Exhaust Review

    h30190/HJPLUS_Taiwan_Architect_KB

    This skill should be used when evaluating smoke exhaust compliance for buildings in Taiwan, including windowless floor determination, smoke compartment partitioning, smoke exhaust window effective…

    158 GitHub stars~1.9k tokensUpdated 3 days ago
    Auto-check passed

Questions about Urban Road Code Fundamentals

What does Urban Road Code Fundamentals do?

This skill should be used to establish which instrument and which version govern before applying any Taiwan Urban Road Design Code (市區道路及附屬工程設計規範) dimension: the standard-versus-code hierarchy, the…. Urban Road Code Fundamentals is an agent skill from h30190/HJPLUS_Taiwan_Architect_KB. This skill should be used to establish which instrument and which version govern before applying any Taiwan Urban Road Design Code (市區道路及附屬工程設計規範) dimension: the standard-versus-code hierarchy, the 應/不得/宜/不宜 wording rules, the provincial-highway co-alignment rule, road classification and design speed, and the full chapter map.

When should I use Urban Road Code Fundamentals?

Urban Road Code Fundamentals fits situations like: tasks that involve Accessibility.

How do I install Urban Road Code Fundamentals in Claude Code?

Run `npx skills add h30190/HJPLUS_Taiwan_Architect_KB --skill urban-road-code-fundamentals -a claude-code`. Or copy the skill folder (raw/公共工程/市區道路及附屬工程設計規範/urban-road-code-fundamentals in h30190/HJPLUS_Taiwan_Architect_KB) into .claude/skills/urban-road-code-fundamentals in your project. Claude Code loads it when a task matches its description.

How do I install Urban Road Code Fundamentals in Codex?

Run `npx skills add h30190/HJPLUS_Taiwan_Architect_KB --skill urban-road-code-fundamentals -a codex`. Or copy the skill folder (raw/公共工程/市區道路及附屬工程設計規範/urban-road-code-fundamentals in h30190/HJPLUS_Taiwan_Architect_KB) into .agents/skills/urban-road-code-fundamentals in your project. Codex loads it when a task matches its description.

Can I use Urban Road Code Fundamentals 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 h30190/HJPLUS_Taiwan_Architect_KB --skill urban-road-code-fundamentals -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/urban-road-code-fundamentals, .gemini/skills/urban-road-code-fundamentals, .github/skills/urban-road-code-fundamentals and .opencode/skills/urban-road-code-fundamentals in your project.

What does Urban Road Code Fundamentals need to run?

SKILL.md names no scripts, command-line tools or credentials: Urban Road Code Fundamentals is instructions for the agent only. Our summary lists: Python 3. Compatibility (from SKILL.md): claude-code,opencode,agent-skills.

Does Urban Road Code Fundamentals 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 Urban Road Code Fundamentals 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 Urban Road Code Fundamentals use?

Urban Road Code Fundamentals is published under the CC-BY-SA-4.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Urban Road Code Fundamentals use?

About 2.4k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.1k tokens, read only when the agent opens those files.

What are the alternatives to Urban Road Code Fundamentals?

Skills that share tags, products or a category with Urban Road Code Fundamentals: Web Interface Guidelines Reviewer (vercel-labs/openreview, 1.7k stars), Accessibility Review (markmead/hyperui, 12k stars), Web Animation Design (baptisteArno/typebot.io, 11k stars) and Accessibility Fixer (ibelick/ui-skills, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Urban Road Code Fundamentals?

h30190 (a GitHub user) maintains it in h30190/HJPLUS_Taiwan_Architect_KB, which has 158 GitHub stars. The repository holds 86 skills in this directory. The repository was last updated on October 8, 2026.

Source: h30190/HJPLUS_Taiwan_Architect_KB on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.