Agent skill

AI Self Improvement

by JocysCom in JocysCom/FocusLogger

Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills).

GPL-3.0Auto-check passedAgent Workflows

Install AI Self Improvement

skills CLI
$ npx skills add JocysCom/FocusLogger --skill ai-self-improvement -a claude-code

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

GitHub CLI
$ gh skill install JocysCom/FocusLogger ai-self-improvement --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/JocysCom/FocusLogger.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.ai/skills/ai-self-improvement .claude/skills/ai-self-improvement && 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
ai-self-improvement
GitHub stars
213
Token cost
~1.1k tokens
SKILL.md length
399 words
Files
5 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
GPL-3.0

At a glance

Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills).

  • Works in 3 steps: Locate the source file under .ai/ (not… → Make changes to the .ai/ source → Run the sync script to propagate changes…
  • The user asks to create
  • SKILL.md covers Critical: .ai/ is the Primary…, Path Mapping Reference, Editable instruction files… and Workflow, plus 4 more sections
  • Runs PowerShell and Python scripts from its folder

What it does

AI Self Improvement is an agent skill from JocysCom/FocusLogger. Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills). Use when the user asks to create or edit a skill/SKILL.md, modify the agent's own instructions/processes, restructure instruction governance, migrate instruction content into skills, or run/adjust the sync pipeline that publishes .ai/ sources into agent-specific folders. Load this skill before writing any SKILL.md, .instructions.md, or touching any skills/ folder (.ai/, .claude/, .roo/…

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `agents.json`, `evals/evals.json` and `scripts/sync_agent_assets.py`).

It sits in Agent Workflows, covering Agent instruction files. It works with GitHub. The repository describes itself as: Find out which process or program is taking the window focus. In-game controls could temporary stop responding if other program steals the focus. The licence is GPL-3.0.

When your agent uses it

  • The user asks to create
  • Edit a skill/SKILL.md
  • Modify the agents own instructions/processes
  • Restructure instruction governance

Example prompts

  • “/ai-self-improvement”

Requirements

  • Python 3
  • PowerShell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Locate the source file under .ai/ (not the agent-specific output)
  2. Make changes to the .ai/ source
  3. Run the sync script to propagate changes to all agents

What it can do on your machine

Read from SKILL.md and the folder at commit b32c096. 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

    Ships 2 files in scripts/ (PowerShell and Python), which the agent can run.

    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

AI Self Improvement loads about 1.1k tokens when it runs. Until then it costs about 160 tokens; SKILL.md has 399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~160
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from JocysCom/FocusLogger at commit b32c096, republished under its GPL-3.0 licence (© JocysCom). 399 words, ~1,082 tokens.

Download SKILL.mdSave it as .claude/skills/ai-self-improvement/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
ai-self-improvement
description
Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills). Use when the user asks to create or edit a skill/SKILL.md, modify the agent's own instructions/processes, restructure instruction governance, migrate instruction content into skills, or run/adjust the sync pipeline that publishes `.ai/` sources into agent-specific folders. Load this skill before writing any SKILL.md, .instructions.md, or touching any skills/ folder (.ai/, .claude/, .roo/, .github/). It tells you the correct location (.ai/) and the sync step, so files end up in the right place.

AI Self-Improvement (Instructions + Skills)

Critical: .ai/ is the Primary Source for ALL Agents

The .ai/ folder is the single source of truth for all AI agent configurations in this repository. This applies to:

  • CLINE / Roo Code — synced to .roo/rules/ and .roo/skills/
  • GitHub Copilot — synced to .github/copilot-instructions.md
  • OpenAI Codex / AGENTS.md — synced to AGENTS.md at repo root
  • Claude Code — synced to .claude/*.instructions.md and .claude/skills/

IMPORTANT: When asked to modify skills, instructions, or perform any AI self-improvement task, you MUST:

  1. Locate the source file under .ai/ (not the agent-specific output)
  2. Make changes to the .ai/ source
  3. Run the sync script to propagate changes to all agents

Path Mapping Reference

When you encounter a path in an agent-specific folder, map it to .ai/:

Agent-Specific PathSource Path (Edit Here)
.roo/rules/*.md.ai/*.instructions.md
.roo/skills/<name>/SKILL.md.ai/skills/<name>/SKILL.md
.github/copilot-instructions.md.ai/instructions.md (generated)
AGENTS.md.ai/instructions.md (generated)
.claude/*.instructions.md.ai/*.instructions.md
.claude/skills/<name>/SKILL.md.ai/skills/<name>/SKILL.md

Example: If asked to update .roo/skills/ai-self-improvement/SKILL.md, you must edit .ai/skills/ai-self-improvement/SKILL.md instead.

Editable instruction files (sources of truth)

You can update your own instruction files under .ai/:

  • .ai/instructions.md — the main system instructions file
  • .ai/*instructions.md — additional instruction files (auto-included)
  • .ai/*instructions-detail.md — detailed instruction files (read only when needed)
  • .ai/skills/<name>/SKILL.md — skill definition files

Workflow

  1. Treat .ai/ as the single source of truth for agent instructions and skills.
  2. When creating or migrating a skill, create/update it under .ai/skills/.
  3. Make instruction changes in .ai/instructions.md and related *.instructions.md / *.instructions-detail.md files.
  4. Do not edit generated outputs directly (they are produced by the sync script):
    • .roo/rules/
    • .roo/skills/
    • .github/copilot-instructions.md
    • AGENTS.md
    • .claude/
  5. Test changes before syncing — verify scripts execute correctly and changes work as expected.
  6. After testing, run the sync script to apply to all agents.
Show full SKILL.md (126 more words)Show less

Testing Before Sync

Before running the sync script, always verify your changes work correctly:

  • For script changes: Execute the modified script and verify output is correct
  • For instruction changes: Review the markdown renders properly and instructions are clear
  • For skill changes: Test any bundled tools or scripts included in the skill

Example: If you modify a PowerShell script in a skill, run it directly from .ai/skills/<name>/scripts/ to confirm it works before syncing.

Activation process

After editing instruction files (or master skills), run from repository root:

powershell
.\.ai\skills\ai-self-improvement\scripts\Sync-AgentAssets.ps1 AUTO

This script synchronizes changes from .ai/ to all agent-specific folders.

Single source of truth

Never embed template content in instructions — reference template files instead.

Example:

  • ✅ "Template maintained in pr/checklist.template.md"
  • ❌ Pasting template content into instructions

Bundled scripts

  • Sync entrypoint (instructions + skills): .ai/skills/ai-self-improvement/scripts/Sync-AgentAssets.ps1

© JocysCom, GPL-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

SKILL.md and 4 other files (scripts) in .ai/skills/ai-self-improvement of JocysCom/FocusLogger.

  • SKILL.md
  • agents.json
  • evals/evals.json
  • scripts/Sync-AgentAssets.ps1
  • scripts/sync_agent_assets.py

Open the folder on GitHubat commit b32c096

Compare with similar skills

AI Self Improvement 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.

AI Self Improvement compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI Self Improvement this skillJocysCom/FocusLogger213—~1.1kAutomated safety check: PassGPL-3.0
Setup Matt Pocock Skillsywwynm/EverythingDone1449 repos~1.7kAutomated safety check: PassGPL-3.0
AI Readyjohnpapa/ai-ready225—~5.4kAutomated safety check: PassMIT
Attmcojp Claude Mdnatsukium/dotfiles106—~1.3kAutomated safety check: NotesCC0-1.0
Workflow Creatornicepkg/ai-workflow285—~2.6kAutomated safety check: PassMIT
Learn From PRdotnet/maui23k—~2.5kAutomated safety check: PassMIT

Similar skills

  • Setup Matt Pocock Skills

    ywwynm/EverythingDone

    Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…

    144 GitHub starsUsed in 9 repos~1.7k tokens
    Agent WorkflowsAuto-check passed
  • AI Ready

    johnpapa/ai-ready

    ANALYSIS SKILL — Analyze any repository and generate AI-ready configuration — a canonical AGENTS.md, thin per-tool pointer files, skills, CI workflows, issue templates.

    225 GitHub stars~5.4k tokensUpdated 11 days ago
    Agent WorkflowsAuto-check passed
  • Attmcojp Claude Md

    natsukium/dotfiles

    Change the org-level CLAUDE.md that governs every attmcojp repository.

    106 GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Workflow Creator

    nicepkg/ai-workflow

    Create complete Claude Code workflow directories with curated skills.

    285 GitHub stars~2.6k tokensUpdated 8 mo ago
    Agent WorkflowsAuto-check passed
  • Learn From PR

    dotnet/maui

    Official

    Analyzes a finished pull request that involved an agent to find what slowed or helped it, and recommends specific changes to instruction files, skills and docs.

    23k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Pending Verify Issue

    jinzhongjia/decky-music

    把"已提交但尚未真机验证"的改动登记成 GitHub issue,避免未验收当已完成。当改动触碰 AGENTS.md 要求真机验收的运行时/UI 行为,但验证被阻塞(没拿到部署授权、或用户选择先提交后验证)时使用。

    122 GitHub stars~334 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from JocysCom/FocusLogger

  • QA Tester

    JocysCom/FocusLogger

    Create and maintain automated tests in Microsoft-native/.NET projects with a minimal stack — MSTest runner, System.Windows.Automation for Windows desktop, Playwright for real browser smoke.

    213 GitHub stars~12k tokensUpdated 3 mo ago
    Auto-check passed
  • Solution Patterns

    JocysCom/FocusLogger

    Establish and enforce deterministic path patterns across Code ↔ UI route/menu ↔ Test for any project.

    213 GitHub stars~8k tokensUpdated 3 mo ago
    Auto-check passed
  • Mermaid Rasterize

    JocysCom/FocusLogger

    Rasterize specific mermaid blocks inside a markdown file into PNG images.

    213 GitHub stars~835 tokensUpdated 3 mo ago
    Auto-check passed
  • Repo Documentation Gatherer

    JocysCom/FocusLogger

    Gather, improve, and curate repository documentation and wiki content.

    213 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • PR Review

    JocysCom/FocusLogger

    AI-assisted pull request review workflow for Azure DevOps Git repositories.

    213 GitHub stars~12k tokensUpdated 3 mo ago
    Auto-check: warnings
  • Repository Analysis

    JocysCom/FocusLogger

    Generate or refresh .ai/repository-analysis.instructions.md whenever the user needs a repository-wide map of architecture, projects, technology stack, developer workflows, CI/testing, documentation…

    213 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Categories

Questions about AI Self Improvement

What does AI Self Improvement do?

Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills). AI Self Improvement is an agent skill from JocysCom/FocusLogger. Update, create, improve, and synchronise this repository's AI agent instructions and related assets (including skills).

When should I use AI Self Improvement?

AI Self Improvement fits situations like: the user asks to create; edit a skill/SKILL.md; modify the agents own instructions/processes; restructure instruction governance.

How do I install AI Self Improvement in Claude Code?

Run `npx skills add JocysCom/FocusLogger --skill ai-self-improvement -a claude-code`. Or copy the skill folder (.ai/skills/ai-self-improvement in JocysCom/FocusLogger) into .claude/skills/ai-self-improvement in your project. Claude Code loads it when a task matches its description.

How do I install AI Self Improvement in Codex?

Run `npx skills add JocysCom/FocusLogger --skill ai-self-improvement -a codex`. Or copy the skill folder (.ai/skills/ai-self-improvement in JocysCom/FocusLogger) into .agents/skills/ai-self-improvement in your project. Codex loads it when a task matches its description.

Can I use AI Self Improvement 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 JocysCom/FocusLogger --skill ai-self-improvement -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ai-self-improvement, .gemini/skills/ai-self-improvement, .github/skills/ai-self-improvement and .opencode/skills/ai-self-improvement in your project.

What does AI Self Improvement need to run?

Going by SKILL.md and its folder, AI Self Improvement needs PowerShell and Python for the scripts in its folder. Our summary lists: Python 3; PowerShell.

Does AI Self Improvement 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 AI Self Improvement 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does AI Self Improvement use?

AI Self Improvement is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does AI Self Improvement use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 AI Self Improvement?

Skills that share tags, products or a category with AI Self Improvement: Setup Matt Pocock Skills (ywwynm/EverythingDone, 144 stars), AI Ready (johnpapa/ai-ready, 225 stars), Attmcojp Claude Md (natsukium/dotfiles, 106 stars) and Workflow Creator (nicepkg/ai-workflow, 285 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI Self Improvement?

JocysCom (a GitHub organization) maintains it in JocysCom/FocusLogger, which has 213 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on June 30, 2026.

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