amanbh997/skills-architects/daylighting-design
Claude Code and agent skill by amanbh997/skills-architects
- community
Checking that the SKILL.md file is still in the repository.
Natural daylighting strategies, solar geometry, glare control, artificial lighting integration, and visual comfort for architectural design
Install
npx vskill@latest install amanbh997/skills-architects/daylighting-designSKILL.md
Daylighting Design
Comprehensive knowledge base for natural daylighting strategies, solar geometry, shading device design, glare control, artificial lighting integration, and visual comfort optimization. Invoke this skill when addressing questions about window design, daylight simulation, shading calculations, lighting zones, circadian lighting, daylight metrics (sDA, ASE, UDI, DF), or any design decision involving natural light in buildings.
Section 1: Daylight Metrics
1.1 Daylight Factor (DF)
The Daylight Factor is the ratio of internal illuminance at a point on the working plane to the simultaneous unobstructed external horizontal illuminance under a CIE overcast sky, expressed as a percentage.
Formula: DF (%) = (E_internal / E_external) × 100
Components:
- Sky Component (SC) — direct light from visible sky through the window
- Externally Reflected Component (ERC) — light reflected from external surfaces (ground, adjacent buildings)
- Internally Reflected Component (IRC) — light reflected from internal room surfaces (ceiling, walls, floor)
Typical CIE overcast sky reference illuminance: 10,000-15,000 lux (design value: 10,000 lux for conservative analysis)
DF Targets by Space Type:
| Space Type | Average DF Target | Minimum Point DF | Notes | |
|---|---|---|---|---|
| Residential — living rooms | ≥ 2.0% | ≥ 0.5% | BS 8206-2, BS EN 17037 | |
| Residential — bedrooms | ≥ 1.5% | ≥ 0.3% | Some codes accept ≥ 1.0% | |
| Residential — kitchens | ≥ 2.0% | ≥ 0.6% | Task lighting critical | |
| Office — open plan | ≥ 2.0% | ≥ 0.7% | 300 lux at desk level | |
| Office — private/cellular | ≥ 1.5% | ≥ 0.5% | Window proximity advantage | |
| Schools — classrooms | ≥ 2.0% | ≥ 0.7% | Uniformity ratio ≥ 0.3 | |
| Schools — laboratories | ≥ 2.5% | ≥ 0.8% | High visual task demand | |
| Hospitals — wards | ≥ 2.0% | ≥ 0.5% | Patient wellbeing critical | |
| Hospitals — operating theatres | Artificial only | N/A | Controlled lighting required | |
| Retail — general sales | ≥ 2.0% | ≥ 0.5% | Display lighting supplements | |
| Libraries — reading areas | ≥ 2.5% | ≥ 0.8% | 500 lux on reading plane | |
| Museums — galleries | 1.0-3.0% | Variable | UV control critical; max 200 lux for sensitive works |
Uniformity: Minimum-to-average DF ratio should be ≥ 0.3 (0.4 preferred). Values below 0.3 indicate excessive contrast between window-side and room-depth zones.
Limitations of DF: Assumes CIE overcast sky only; ignores building orientation, climate, direct sunlight, and temporal variation. Use Climate-Based Daylight Modelling (CBDM) for performance-based analysis.
1.2 Spatial Daylight Autonomy (sDA300/50%)
sDA measures the percentage of floor area that receives at least 300 lux from daylight alone for at least 50% of occupied hours annually.
Standard: IES LM-83-12 (Approved Method for Spatial Daylight Autonomy and Annual Sunlight Exposure)
Calculation Method:
- Define analysis grid (typically 0.76 m / 30 in above floor, grid spacing ≤ 0.6 m)
- Use annual climate-based simulation (hourly timestep, TMY weather data)
- At each grid point, count hours where daylight illuminance ≥ 300 lux
- Point passes if ≥ 50% of occupied hours meet threshold
- sDA = percentage of passing grid points / total grid points
Performance Targets:
- sDA ≥ 55% — acceptable (LEED v4 Daylight credit Option 1: 2 points)
- sDA ≥ 75% — preferred (LEED v4 Daylight credit Option 1: 3 points)
- sDA ≥ 40% — minimum for EN 17037 Level I (Minimum)
- sDA ≥ 50% — EN 17037 Level II (Medium)
- sDA ≥ 65% — EN 17037 Level III (High)
LEED v4.1 BD+C: Daylight Credit EQ Credit — Demonstrate sDA300/50% ≥ 55% in ≥ 55% of regularly occupied floor area (2 points) or ≥ 75% of regularly occupied floor area (3 points), AND ASE1000,250 ≤ 10%.
1.3 Annual Sunlight Exposure (ASE1000,250)
ASE measures the percentage of floor area that receives at least 1,000 lux of direct sunlight for 250 or more occupied hours per year. It is a glare risk indicator.
Threshold: ASE1000,250 ≤ 10% of regularly occupied floor area
Calculation:
- Uses direct sun only (excludes diffuse sky)
- Same analysis grid as sDA
- Counts hours of ≥ 1,000 lux direct beam illuminance per point
- Point fails if ≥ 250 hours exceed threshold
- ASE = percentage of failing points
Interpretation:
- ASE ≤ 3% — excellent glare control
- ASE 3-7% — acceptable with operable shading
- ASE 7-10% — marginal; requires automated shading
- ASE > 10% — fails LEED; visual discomfort likely; redesign fenestration/shading
Critical: ASE can be reduced without harming sDA by adding external shading devices that block direct sun while admitting diffuse sky light.
1.4 Useful Daylight Illuminance (UDI)
UDI classifies daylight illuminance at each analysis point into four bins, evaluated hourly across the year.
Bins:
- UDI-f (fell-short): < 100 lux — insufficient daylight; electric lighting required
- UDI-s (supplementary): 100-300 lux — useful but may need supplementary electric light
- UDI-a (autonomous): 300-3,000 lux — ideal range; daylight sufficient, no glare risk
- UDI-e (exceeded): > 3,000 lux — potential glare and overheating risk
Targets:
- Maximize UDI-a (300-3,000 lux): aim for ≥ 50% of occupied hours at ≥ 50% of floor area
- Minimize UDI-e: aim for < 5% of occupied hours at perimeter zones
- UDI-f + UDI-s indicates electric lighting dependency
Advantages over DF: Climate-specific, accounts for orientation, captures both insufficient and excessive daylight conditions, annual temporal resolution.
1.5 Daylight Glare Probability (DGP)
DGP is a luminance-based metric predicting the probability of glare from a specific viewpoint. Calculated from high-dynamic-range (HDR) luminance maps using Evalglare (part of Radiance).
Classification:
- DGP < 0.35 (35%) — imperceptible glare (best practice target)
- DGP 0.35-0.40 — perceptible glare
- DGP 0.40-0.45 — disturbing glare
- DGP > 0.45 — intolerable glare
Simplified DGP (DGPs): Vertical eye illuminance-based approximation: DGPs = 6.22 × 10⁻⁵ × E_v + 0.184 (where E_v = vertical illuminance at eye in lux). Valid for DGP < 0.45.
1.6 Additional Metrics
- Daylight Autonomy (DA): Percentage of occupied hours a single point receives ≥ target illuminance from daylight. Point-based predecessor to sDA.
- Continuous Daylight Autonomy (cDA): Gives partial credit for values below threshold (e.g., 200 lux counts as 200/300 = 0.67 at 300 lux target).
- Mean Daylight Factor: Area-weighted average DF across analysis grid.
- Vertical Illuminance (E_v): Illuminance on a vertical plane at eye height; critical for circadian stimulus (target ≥ 250 melanopic lux at eye level during morning hours).
- View Factor: Solid angle of sky visible from a point; correlates strongly with DF.
Section 2: Daylighting Strategies
2.1 Side-Lighting (Window Design)
The most common daylighting strategy. Daylight enters through vertical apertures in exterior walls.
Key Parameters:
- Window Head Height (H_w): Determines depth of daylight penetration. Effective daylit zone depth = 1.5× to 2.5× window head height. Rule of thumb: 2.0× H_w for side-lit rooms.
- Window-to-Wall Ratio (WWR): Total glazed area / gross exterior wall area. Typical ranges: 25-40% for energy-optimized designs; 40-60% for daylight-prioritized; > 60% requires high-performance glazing and shading.
- Sill Height: 0.8-1.0 m typical for view windows; lower sills (0.3-0.5 m) for seated occupants; higher sills (1.5-2.1 m) for clerestories.
- Plan Depth Limit: Maximum room depth for adequate side-lighting = 2.5 × H_w. Beyond this, DF drops below 1% and electric lighting becomes primary.
WWR by Orientation (temperate climates, 40-55°N):
- North: 30-50% WWR (diffuse light, low solar gain, minimal glare)
- South: 25-40% WWR (controllable with horizontal overhangs, high winter gain)
- East: 20-30% WWR (morning glare risk, difficult to shade)
- West: 15-25% WWR (afternoon glare and overheating, hardest orientation to shade)
DF Improvement: Each 10% increase in WWR adds approximately 0.5-1.0% to average DF (diminishing returns above 50% WWR due to room surface reflectance limits).
Cost: Standard window assemblies $300-800/m²; high-performance triple glazing $600-1,200/m².
Best For: All building types; universal applicability.
2.2 Top-Lighting
Light enters from roof-level apertures. Up to 3× more efficient than side-lighting per unit aperture area because light enters from directly overhead.
Types:
Skylights:
- Horizontal or slightly tilted (5-15° for drainage)
- Aperture area: 3-5% of floor area provides DF ≈ 2-4% below skylight
- Risk: overheating and excessive brightness directly below; use diffusing glazing or baffles
- Suitable glazing: translucent polycarbonate, opal glass, prismatic diffusers, aerogel-filled panels
Monitor Roofs (Raised Clerestory):
- Vertical or near-vertical glazing on raised roof section
- Can be oriented north for glare-free diffuse light
- Effective for deep-plan single-storey buildings (factories, galleries, studios)
- Depth of light throw: 1.0-1.5× monitor height
Sawtooth Roofs:
- Repeated asymmetric profiles with north-facing glazing (Southern Hemisphere: south-facing)
- Provides uniform illumination across large floor plates
- Optimal pitch: 30-45° for glazed face; 15-25° for opaque face
- DF achievable: 3-6% uniform
- Classic industrial typology; revived in modern schools and offices
Light Wells:
- Vertical shaft from roof to lower floors
- W:H ratio ≥ 1:3 for reasonable bottom illuminance (DF ≈ 0.5-1.0% at base)
- Reflective lining (white paint ρ ≥ 0.85, or mirrored surfaces ρ ≥ 0.92) essential
- Can combine with atrium for multi-storey distribution
Cost: Skylights $400-1,500/m²; monitor roofs +15-25% over standard roof; sawtooth +20-35%.
Best For: Single-storey buildings, top floors of multi-storey, galleries, industrial, retail.
2.3 Atrium Lighting
Atria serve as internal daylight distributors, bringing light into deep-plan multi-storey buildings.
Design Parameters:
- Well Index (WI): WI = H × (W + L) / (2 × W × L) where H = atrium height, W = width, L = length. Lower WI = more light at base.
- Target: WI ≤ 2.0 for DF ≥ 2% at ground floor; WI ≤ 1.5 for DF ≥ 3%
- Aspect Ratio: Width-to-height ratio ≥ 1:3 (minimum); 1:2 preferred; 1:1 ideal but area-expensive
- Surface Reflectances: Atrium walls ρ ≥ 0.6 (white: 0.7-0.85); floor ρ ≥ 0.3
- Roof Glazing: Clear or fritted glass; ETFE cushions; operable vents for ventilation
Borrowed Light: Rooms facing atrium receive side-light from atrium void. Glazed atrium-facing walls critical.
Exemplars: Ford Foundation HQ (Roche Dinkeloo), Bradbury Building (Wyman), National Gallery East Wing (Pei), Rijksmuseum atrium (Cruz y Ortiz).
Cost: Atrium construction premium +20-40% over equivalent solid floor area; long-term energy savings in lighting 30-50%.
2.4 Light Shelves
Horizontal reflective elements mounted at or near window mid-height, dividing the window into a lower view zone and an upper daylight zone.
Design Rules:
- Mount height: 2.0-2.4 m above floor (above eye level of seated occupants)
- Shelf depth (external): 0.6-1.2 m (effective throw into room = 1.5-2.0× external shelf depth)
- Shelf depth (internal): 0.3-0.8 m (secondary redistribution)
- Shelf surface: highly reflective (ρ ≥ 0.85); specular aluminum, white painted metal
- Upper glazing above shelf: clear or lightly tinted (maximize VLT)
- Lower glazing below shelf: can be tinted, fritted, or with blinds for glare control
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/daylighting-design/SKILL.md
Popularity
- Repository stars
- 158
- Repository forks
- 31
- 7-day trend score
- 25
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 29 Apr 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/amanbh997/skills-architects/daylighting-design)