Agent Skill
2/7/2026

akis-dev

Load when editing .github/copilot-instructions*, skills/*, agents/*, instructions/*, or project_knowledge.json. Provides AKIS framework development patterns optimized for minimal tokens with full completeness.

G
goranjovic55
0GitHub Stars
1Views
npx skills add goranjovic55/LOGReport

SKILL.md

Nameakis-dev
DescriptionLoad when editing .github/copilot-instructions*, skills/*, agents/*, instructions/*, or project_knowledge.json. Provides AKIS framework development patterns optimized for minimal tokens with full completeness.

name: akis-dev description: Load when editing .github/copilot-instructions*, skills/, agents/, instructions/*, or project_knowledge.json. Provides AKIS framework development patterns optimized for minimal tokens with full completeness.

AKIS Development

Target: -68% tokens, 100% completeness, identical behavior

Core Principle: Single-Source DRY

RuleDescription
One source of truthEach rule exists in ONE file only
Reference don't repeatOther files say "see X" not copy X
Unique content onlyEach file has ONE purpose, no overlap

File Architecture

FileContainsDoes NOT Contain
copilot-instructions.mdAll core rules, gates, workflowDetails, examples beyond 1
workflow.instructions.mdEND phase details, log formatGates, START (in main)
protocols.instructions.mdSkill triggers, pre-commit, statsGates, workflow (in main)
quality.instructions.mdGotchas table onlyRules (in main)

Optimization Rules

RuleBeforeAfterSavings
Tables over proseParagraph explaining XTable with X-60%
One example not four4 identical examples1 example-75%
DeduplicateSame table in 3 filesTable in 1 file-66%
Compress headers## ⛔ Section Name (REQUIRED)## Section-40%
Remove redundant"This is important because..."(just the rule)-80%

Anti-Patterns

❌ Bad✅ GoodWhy
Same example 4 times1 example in main file-75% tokens
Gates table in 3 filesGates in copilot-instructions only-66% tokens
Verbose explanationTable rowSame info, fewer tokens
"CRITICAL", "MANDATORY" spamOne ⛔ per section maxReduces noise
Numbered sub-sub-stepsFlat listEasier to scan

Template: Compact Instruction File

---
applyTo: '**'
description: 'One line: what unique content this adds.'
---

# Title

> Core rules in copilot-instructions.md. This file: [unique purpose].

## Unique Section 1
| Col | Col |
|-----|-----|
| ... | ... |

## Unique Section 2
Brief content that exists NOWHERE ELSE.

Template: Compact Main File

# AKIS v7.4

## Gates
| G | Check | Fix |
|---|-------|-----|
| 0 | ... | ... |

## START
1. Step one
2. Step two
3. **Announce:** `format`

## WORK
| Trigger | Skill |
|---------|-------|

## END
1. Step one
2. Step two

## Delegation
| Tasks | Action |
|-------|--------|

## Gotchas
| Issue | Fix |
|-------|-----|

Optimization Checklist

Before saving AKIS file:

  • Does this content exist elsewhere? → Remove, add reference
  • Can table replace prose? → Convert
  • Multiple examples of same pattern? → Keep 1
  • Verbose header? → Simplify
  • Can agent execute with ONLY this file? → Yes = complete

Completeness Verification

# Check all rules present across files
grep -h "pattern1\|pattern2" .github/*.md .github/instructions/*.md

Required rules (must exist in at least ONE file):

  • G0-G7 gates
  • START/WORK/END phases
  • Structured TODO format
  • Delegation rules (6+)
  • Parallel execution (60%)
  • Symbols line
  • Gotchas table

Metrics Target

MetricTarget
Token reduction≥65% vs verbose
Line reduction≥60% vs verbose
Completeness100% (all rules present)
BehaviorIdentical (same simulation results)

Commands

TaskCommand
Measure tokenswc -w file.md × 1.3
Check duplicationgrep -h "pattern" files | sort | uniq -c
Verify completenessgrep "required_pattern" files
Run simulationpython .github/scripts/akis_compliance_simulation.py
Skills Info
Original Name:akis-devAuthor:goranjovic55