skills.rest
macrat
macratCOMMUNITY
Explore all skills by this author →
Website𝕏@macrat_jpGitHub

suggest-improve

Conduct multi-perspective code reviews and generate GitHub Issues for improvements.

Updated Feb 5, 2026
Search Tags:#architecture#code review#refactoring#ux#issue generation#product improvement
One-click install
npx skills add https://github.com/macrat/markdown-board --skill suggest-improve
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: suggest-improve
Source: https://github.com/macrat/markdown-board/tree/main/.claude/skills/suggest-improve
Command: npx skills add https://github.com/macrat/markdown-board --skill suggest-improve

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the comprehensive review of a codebase, identifying technical debt, architectural flaws, UI/UX issues, and opportunities for new value, all aligned with the product's core philosophy. It then generates actionable GitHub Issues for these findings.

Core Features & Use Cases

  • Multi-faceted Code Analysis: Evaluates code from technical, architectural, UI/UX, and product philosophy perspectives.
  • Proactive Improvement Suggestions: Identifies areas for enhancement and proposes concrete solutions.
  • New Value Creation: Brainstorms and suggests innovative features or use cases that align with the product vision.
  • GitHub Issue Generation: Automatically creates well-defined GitHub Issues for all actionable recommendations.
  • Use Case: A developer can use this Skill to get a holistic health check of their project, ensuring it remains maintainable, user-friendly, and aligned with its strategic goals, with all findings neatly organized as actionable tasks.

Quick Start

Initiate a comprehensive review of the current codebase to identify areas for improvement and new feature opportunities.

Frequently Asked Questions about suggest-improve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code review to identify technical debt and architectural flaws?▼

Automated code review evaluates your codebase from technical, architectural, and UI/UX perspectives to identify technical debt and architectural flaws. It then generates structured GitHub Issues for actionable refactoring and improvements.

Can I automatically generate GitHub Issues for UX enhancements and new feature proposals?▼

Yes, you can automatically generate well-defined GitHub Issues for UX enhancements and new feature proposals. The review process brainstorms value-creating features aligned with product philosophy and outputs them as actionable tasks.

What is a multi-perspective code review and how does it align with product philosophy?▼

A multi-perspective code review analyzes a project across technical, architectural, UI/UX, and product dimensions. It ensures identified improvements and new value-creating features align with core principles and architecture decision records.

Does this code review approach work for brainstorming new value-creating product features?▼

Yes, this code review approach proactively identifies areas for enhancement and brainstorms innovative new features. It evaluates opportunities against your product vision to propose concrete, value-creating solutions.

How to conduct a holistic project health check for maintainability and UX issues?▼

Conduct a holistic project health check by running a comprehensive codebase review that evaluates maintainability, architectural soundness, and UX issues. This process identifies technical debt and outputs all findings as organized GitHub Issues.

What are the limitations of automated issue generation for architectural refactoring?▼

Automated issue generation focuses on identifying actionable items for architectural refactoring and technical debt but requires a defined product philosophy and existing architecture decision records to ensure accurate alignment.

Related Skills

Explore More Software Engineering Skills→
ricardoalt1515ricardoalt1515

to-prd

Generate a Product Requirements Document from conversation context and codebase understanding.

Community
Advanced
lovecrushfamilylovecrushfamily
1

vc-predict

Analyze proposed changes with expert personas to predict architectural, security, performance, and UX issues.

Community
Advanced
nanorepublicananorepublica
61

Testing Unit Tests

Standardize unit-test coding practices across Claude Code projects.

Community
Basic
nerdsanenerdsane
46

desloppify

Scan codebases for quality issues and technical debt across 28 languages.

Community
Advanced