Web-Based Kuk Sool Technique Tester

This personal project involved creating a dynamic, browser-based Kuk Sool Won (martial arts) self-defence technique tester using HTML, CSS, and JavaScript. As part of my preparation for fourth degree black belt testing — after over twenty years of training — I needed to memorise and practise 444 self-defence techniques, in addition to the rest of Kuk Sool’s extensive curriculum. This is no small task.

Over the years, various tools were created to help, including a spreadsheet randomiser built by one of my instructors, and I created a Siri Shortcut for use on iOS devices. Whilst functional, these were limited by platform restrictions, or a lack of flexibility. Wanting something better, I set out to build a more accessible and efficient solution.

For the first time, I collaborated with AI to assist in development — a new experience that challenged me to clearly articulate requirements, troubleshoot effectively, and maintain the integrity of the resource throughout. It became a rewarding exercise in both technical problem-solving and communication.

This resource will continue to grow as I add new features based on my own reflections and feedback from other Kuk Sool practitioners. When I shared the first public version on 22 May 2025, it included the following features:

• Rank-Based Set Selection
  Quickly select all relevant technique sets based on belt rank (from White Belt to Fourth Degree Black Belt), including inherited sets from previous ranks.

• Manual Set Selection
  Choose specific technique sets manually from a comprehensive list, with visual indicators of how many techniques are in each.

• Multiple Generation Modes
  • Generate a specific number of random techniques from across all selected sets
  • Generate a fixed number of techniques per selected set.
• Randomisation Options
  • Randomise the order of sets (per-set mode)
  • Randomise the order of techniques within each set (full mode).

• Step-by-Step Display
  Techniques are shown one at a time with large, centred text to support focused solo practice.

• Feedback System
  Users rate each technique as “correct” or “incorrect” using intuitive thumbs-up/down buttons.

• End-of-Session Summary
  A clear summary appears at the end showing which techniques were marked correct/incorrect, using coloured text.

• Fully Browser-Based & Mobile-Friendly
  No installation required — works seamlessly on desktop and mobile.

On 25 May 2025, several new features were added:

• Score Box
  I added a colour-coded score box to the end-of-session summary that shows users’ overall score as a percentage, as determined by their use of the intuitive thumbs-up/down button feedback system. This was a suggestion from someone who used the resource.

• Additional Generation Methods
  I added a feature to go through every technique in the selected sets, with the option to show them in order or shuffled. This helps users identify personal weak areas in their syllabus. I included it because I knew it would be useful for my own training too.

• Better Randomisation
  The original resource didn’t keep track of which techniques had already been shown, so users could get the same one multiple times while missing others completely. To fix this, I added a feature called tiered repetition control. This ensures that every technique is shown once before any repeats happen, and that no technique appears a third time until all others have been shown twice — and so on. I added this feature because I personally wanted more balanced practise.

• Visual Improvements
  I added ✅ and ❌ emojis in the end-of-session summary, to mark which techniques were correct or incorrect. This made things clearer and more accessible, especially for users who might have trouble seeing green and red text colours used in the original version.